Skip to main content
POST
/
api
/
v1
/
tasks
/
{id}
/
comments
Create comment
curl --request POST \
  --url https://api.getarca.app/api/v1/tasks/{id}/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>"
}
'
{
  "id": 172,
  "task_id": 101,
  "user_id": 1,
  "name": "Alice",
  "avatar_url": null,
  "content": "Deploying to staging tonight.",
  "parent_comment_id": null,
  "resolved": false,
  "created_at": "2026-03-18T20:00:00.000Z"
}
Requires the comments:write scope. Viewers cannot post comments.

​
Path parameters

​
id
string
required
The numeric task ID.

​
Request body

​
content
string
required
Comment text. HTML tags are sanitized, only safe inline elements are kept. Whitespace-only content is rejected with 400.

​
Response

Returns the created comment. resolved is always false for a new comment.
​
id
number
required
New comment identifier.
​
task_id
number
required
ID of the task this comment belongs to.
​
user_id
number
required
ID of the API key owner (the commenter).
​
name
string
required
Display name of the commenter.
​
avatar_url
string | null
Profile picture URL of the commenter.
​
content
string
required
Sanitized comment content.
​
parent_comment_id
null
required
Always null. Threading is not supported via the API.
​
resolved
boolean
required
Always false for newly created comments.
​
created_at
string
required
UTC ISO-8601 creation timestamp.
{
  "id": 172,
  "task_id": 101,
  "user_id": 1,
  "name": "Alice",
  "avatar_url": null,
  "content": "Deploying to staging tonight.",
  "parent_comment_id": null,
  "resolved": false,
  "created_at": "2026-03-18T20:00:00.000Z"
}