Send message
Sends a user message to the conversation and returns the AI agent’s response. Supports both streaming (Server-Sent Events) and non-streaming (JSON) response modes. This endpoint is rate-limited.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the app.
The unique identifier of the conversation.
Body
The message object to send.
Override the app's default streaming setting for this request. When true, the response is delivered as Server-Sent Events (SSE). When false, a single JSON response is returned. If omitted, the app's configured default is used.
Arbitrary key-value context to enrich the AI agent's response. Pass the latest snapshot on any message, and the agent will use this fresh context for the current response and persist it as the conversation's latest metadata. Maximum 16KB.
Response
OK
Unique identifier for the response.
Unix timestamp (in seconds) of when the response was generated.
The ID of the conversation this response belongs to.
The object type. Always 'response'.
The list of output items produced by the AI agent, including messages and function calls.
The status of the response. Either 'completed' or 'failed'.

