Allo

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

StatusCodeWhen
400EMPTY_NOTE_CONTENTcontent is missing or blank
400NOTE_CONTENT_TOO_LONGcontent exceeds 4,000 characters
404THREAD_NOT_FOUNDNo 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
idstring
namestring | null
mentionsobject[]
3 fields
user_idstring
namestring | null
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