Add comment
POST
https://example.kaiten.ru/api/latest/cards/{card_id}/comments| Name | Type | Reference |
|---|---|---|
| card_idrequired | integer | Card ID |
| Name | Value | Description |
|---|---|---|
| Content-Type | application/json, multipart/form-data | When uploading files use multipart/form-data, otherwise any type |
| Name | Type | Constraints | Description |
|---|---|---|---|
text required | string | minLength: 0 maxLength: 4096 | Comment |
files[] | array of binary files |
Responses
| Description | Response type | Example |
|---|---|---|
| Success | Object |
| Name | Type | Description |
|---|---|---|
| updated | string | Last update timestamp |
| created | string | Create date |
| id | integer | Comment id |
| uid | integer | Comment uid |
| text | string | Comment text |
| type | enum | 1-markdown, 2-html |
| edited | boolean | Is comment edited |
| card_id | integer | Card id |
| author_id | integer | Author id |
| email_addresses_to | string | Mail addresses to send comment |
| internal | boolean | Internal flag |
| deleted | boolean | Deleted flag |
| sd_external_recipients_cc | string | Service desk external recipients |
| sd_description | boolean | Flag indicating that the comment is used as a request description when the card is a service desk request |
| notification_sent | string | Notification_sent date |
| attacments | array of objects | Comment attacments |
| Description | Response type | Example |
|---|---|---|
| Validation error | Object |
| Name | Type | Description |
|---|---|---|
| message | string | Error message |
| Description | Response type | Example |
|---|---|---|
| Invalid token | String |
A schema has not been defined for this response code.
| Description | Response type | Example |
|---|---|---|
| Forbidden | Response body does not exist |
A schema has not been defined for this response code.
| Description | Response type | Example |
|---|---|---|
| Not found | Response body does not exist |
A schema has not been defined for this response code.
Examples
How to upload files to new comments:
1 curl --request POST \
2 --url 'https://example.kaiten.ru/api/latest/cards/{card_id}/comments' \
3 --header 'Accept: application/json' \
4 --header 'Content-Type: multipart/form-data' \
5 --header 'Authorization: Bearer {yours bearer token}' \
6 --form 'text=test' \
7 --form 'files[]=@/path/to/file1'\
8 --form 'files[]=@/path/to/file2'
9 
Kaiten
If you have any questions or need help with integration feel free to write us at support@kaiten.io
Path Parameters
Upload files
1 curl --request POST \
2 --url 'https://example.kaiten.ru/api/latest/cards/{card_id}/comments' \
3 --header 'Accept: application/json' \
4 --header 'Content-Type: application/json'
5 Response
ClickTry It!to start a request and see the response here!