Comments
Add a comment or reply in an existing thread
Comment threads are used in item discussions, branch discussions and reviews. To start a conversation, pass the item or branch ID as entityId. To join an existing conversation, read it first, then pass the ID of the original comment that started it as entityId, with text in the body. Use that same original comment ID for every follow-up, even when answering another reply. For example, if A starts a thread and B replies to A, answer B using entityId=A, not B. Using B creates a deeper nested reply; the API accepts this, but thread cards and internal AI thread reads do not consistently include deeper replies. Pass branch_id for the branch you are posting on; omit it for Base. The branch is not inherited from the original comment. Posting a reply does not resolve or reopen the thread.
POST
Error
Authorizations
Headers
Workspace identifier
Path Parameters
For a new thread, the item or branch ID. For replies, the ID of the original comment that started the conversation, even when responding to a later reply. For an existing comment, use its returned entity_id when fetching, editing or deleting it.
Body
application/json
Plain-text body of the comment.
Branch to post on, for any comment or reply. Pass the branch ID explicitly when discussing items or the branch there; it is not inherited from the original comment. Omit (or pass "master") to post on Base.
Response
201 - application/json
ID of the user who authored the comment.
ID this comment directly attaches to: an item or branch ID for a conversation starter, or a comment ID for a reply (normally the original comment that started the conversation). Use this value as entityId when fetching, editing or deleting this comment. For older nested replies it may identify another reply, not the conversation starter.
Whether the comment thread has been resolved.
Plain-text body of the comment.
Branch the comment was posted on; absent for the main line.