Create thread comment
Adds a comment to an existing thread.
POST/v2/api/threads/{id}/comments
Behavior
Adds a comment to an existing thread. Comments can be added to resolved threads too.
Mentions
Mention teammates inline in content with @[Display Name](usr-xxxx) — see the mentions guide.
Errors
| Status | Code | When |
|---|
400 | EMPTY_NOTE_CONTENT | content is missing or blank |
400 | NOTE_CONTENT_TOO_LONG | content exceeds 4,000 characters |
404 | THREAD_NOT_FOUND | No thread with this ID |
Authorization
Authorizationstring · headerrequired
Api-Key ak_live_…
Path parameters
idstringrequired
Thread ID (cth-*)
Body
contentstringrequired
Comment text (max 4000 characters). Mention teammates inline with @[Name](usr-...).
Responses
201Comment created
dataobject
6 fields
idstring
Comment ID (thc-*)
contentstring
Comment text, with mentions inline as @[Name](usr-...).
userobject
Author of a note or comment.
2 fields
mentionsobject[]
3 fields
deletedboolean
true if the mentioned user has since been removed from the team.
created_atstring<date-time>
updated_atstring<date-time>
400
401
404
429