v4

latestOpenAPI 3.1.02026-08-019681,1012.0 MB

assistant

Send Message

Send a message to the conversation and stream the assistant's response as SSE events.

404s if the conversation does not exist or is not owned by the caller. 409s if message_id was already submitted (the field is the client-side idempotency key).

post/assistant/conversations/{conversation_id}/messages

Path parameters

conversation_idstring uuid4 required

Request body

message_idstring uuid4 required

Client-generated UUID for this user message. Echoed back in the SSE start event as message_id.

messagestring required

The user's message text.

parent_message_idstring uuid4 nullable

ID of the message this branches from. Null for the first message in a conversation.

modelstring nullable

LLM model to use. Overrides the conversation default for this turn.

Response

Successful Response