Send a message
Appends a user message to a text conversation, runs one agent turn, and returns the agent’s reply.
Constraints: this endpoint applies to text conversations only, and the conversation must be active (status triggered, ringing, or in_progress). Other channels, or conversations that have ended, return 409.
Set interactivity to rich to also receive any UI widgets the agent emitted this turn. Requires a token with write access.
Headers
Organization ID for user PATs (pat_ prefix tokens)
Path Parameters
The text conversation to send the message to.
Body
Body for POST /conversations/{id}/messages (TEXT channel only).
The user's message text
'rich' also returns widgets the agent emitted; 'plain' is text only
plain, rich Response
Successful Response
The response is of type Response Post Text Message Core Conversations Conversation Id Messages Post · object.

