Skip to main content
POST
Create contact comment

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

Org ID

contact_id
string
required

Contact ID

Body

Schema for creating a contact comment

id
string

Client-generated id for the new comment (enables optimistic creation). Encoded (act_…) or raw UUID. Rejected if already in use.

Maximum string length: 128
comment
string

The content of the comment (max 2048 characters)

Maximum string length: 2048
attachments
string[]

Array of file IDs to attach to the comment

Maximum array length: 20
references
object[]

The entities tagged by name in the comment (@Name in the text). A tagged agent answers in the thread; the org id tags Ask Invent

Maximum array length: 20
context
object

Ephemeral context about where the user is when sending the message. Injected into the prompt on the fly, never stored.

Response

200 - application/json

Schema for a contact comment

id
string
required
contact_id
string
required
comment
string | null
required
attachments
object[]
required

Files attached to the comment

created_at
string<date-time> | null
required
updated_at
string<date-time> | null
required
actor
object

User who posted the comment

agent
object

Agent who posted the comment

assistant
object

Assistant who posted the comment

message_id
string

The private note this comment mirrors, when it was written in a conversation

chat
object

The chat behind the comment: the conversation a note was written in, or the run that answered a tag

metadata
object

Activity metadata payload. Discriminated by type, which mirrors the parent activity row type.