v29

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

Chats

Create Chat (Streaming)

Creates a new chat with a user message and returns a Server-Sent Events stream. Events include initial chat state, title deltas, content chunk deltas, and final chat state. The response is text/event-stream; each event is data: <JSON>\n\n where the JSON conforms to ChatStreamEvent.

post/chats/stream

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.

privacy'public' | 'private' | 'team' | 'team-edit' | 'unlisted'

Visibility setting for the new chat.

titlestring

Title for the new chat.

metadataobject

Arbitrary key-value data to attach to the chat.

Response

A single Server-Sent Events payload emitted by streaming chat endpoints. Each SSE event is data: <JSON>\n\n where the JSON conforms to one of the union members.