v44

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-05-192301780.0 KB
Agents

Respond to chat message (streaming)

Streams a single assistant turn as normalized SSE events with stable turn, message, and part IDs. Emits events: turn.started, turn.status, message.created, message.part.updated, message.completed, session.usage, turn.completed.

When to use this endpoint: Recommended for building custom chat UIs that need real-time streaming progress. This is the primary streaming endpoint for new integrations.

Alternatives:

  • POST /chat/:id/message — synchronous, returns complete response as JSON (best for server-to-server)
post/agent/v1/chat/{id}/respond

Path parameters

idstring required

Chat session ID

Request body

Response

Turn-scoped normalized SSE stream