Skip to main content

Generate the next message in a conversation

POST 
/api/v1/conversations/:conversation_id/generate

Generates the next message using the specified actor's linked agent or chat. Background by default: returns 202 Accepted immediately and the reply lands as a new ConversationMessage when it completes — poll GET /api/v1/conversations/{conversation_id}/messages for it. Pass ?wait=true to block and receive the result inline. On completed, the reply is persisted as a new ConversationMessage authored by that actor. On requires_action, nothing is persisted; the caller must submit tool outputs via the Agents module and re-invoke generate — so a flow using client tools should pass ?wait=true.

Request​

Responses​

Generation completed or requires action (only when ?wait=true)