Discussion

Create Task Comments

Deprecated
POST

Adds a Markdown-formatted comment to a task.

Tasks can have discussions attached to them. These discussions can include text with simple formatting. Discussion comments are formatted using Markdown and users should be aware that HTML embedding is not permitted due to the risk of cross-site attacks and other embedding challenges.

Path parameters

taskIdstringRequired
The unique ID number of the task being commented upon

Request

This endpoint expects an object.
text
stringOptional

The text of the comment to add to the discussion, in Markdown format.

Discussion comments are formatted using Markdown and users should be aware that HTML embedding is not permitted due to the risk of cross-site attacks and other embedding challenges.

Response

This endpoint returns an object
error
objectOptional
If the API call failed, this will contain information about the error that occurred.
success
booleanOptional
True if the API call succeeded; false otherwise.
hasError
booleanOptional
True if the API call failed.
statusCode
enumOptional
The HTTP code of the response.
data
objectOptional

Tasks can have discussions attached to them. These discussions can include text with simple formatting. Discussion comments are formatted using Markdown and users should be aware that HTML embedding is not permitted due to the risk of cross-site attacks and other embedding challenges.

POST
1curl -X POST /api/data/tasks/taskId/discussions \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{}'
200
Successful
1{
2 "error": {
3 "technicalError": "technicalError",
4 "additionalErrors": [
5 "additionalErrors"
6 ],
7 "message": "message"
8 },
9 "success": true,
10 "hasError": true,
11 "statusCode": "Continue",
12 "data": {
13 "discussionCommentId": "discussionCommentId"
14 }
15}