Skip to main content
POST
Create record comment

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

Org ID

record_id
string
required

Record ID

Body

Schema for creating a table record 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
Maximum string length: 128
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 table record comment

id
string
required
record_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

chat
object

The run that answered a tag with this comment

metadata
object

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