Skip to main content
GET
List messages
List messages for your workspace, optionally filtered to a conversation. Scope: comms_read

Request

Query parameters

conversation_id
string
Only return messages in this conversation.
since
string
Lower bound timestamp (ISO-8601 when provided).
direction
string
Filter by message direction when supported by your deployment.
limit
integer
Maximum number of messages to return. Must be a positive integer.

Response

Errors

StatusMeaning
401Unauthorized
403Missing comms_read
429Rate limited

See also