v29

latestOpenAPI 3.1.2raw.githubusercontent.com2026-08-014117755.2 KB
Messages

Send Message (Async)

Sends a new message to an existing chat and processes it in the background. Returns immediately with the assistant message ID. Poll GET /chats/:chatId/messages/:messageId and check finishReason to detect completion.

post/chats/{chatId}/messages/async

Path parameters

chatIdstring required

The unique identifier of the chat.

Request body

messagestring required

The prompt or instruction to send to the model.

systemPromptstring

System-level context for the chat, such as frameworks or development environment details.

mcpServerIdsstring[]

MCP server IDs to enable. When omitted, uses default enabled servers.

Response

Acknowledgement that an async message has been queued.

messageIdstring required

ID of the assistant message that will receive the response. Poll GET /chats/:chatId/messages/:messageId and check finishReason for completion.