Stream a query turn's events (SSE)
Server-sent event stream of the turn’s events as they land — the same type-named events POST /query emits with stream: true, but as a standalone, resumable subscription. Reconnect with Last-Event-ID to replay from where the stream dropped.
Authorizations
Session token from POST /auth/login. Pass as Authorization: Bearer <token>. The alternative X-Pinecone-Api-Key header is also accepted for direct-key auth (used by the Nexus CLI on first contact).
Headers
Resume from this event seq; delivery is inclusive of the given id (re-sending the last event is harmless — clients merge steps idempotently by step_id).
Date-based contract version. Omit to resolve to the Nexus default version (2026-07, the oldest served version); send unstable for the in-development surface. The resolved version is echoed back on the same header. A present-but-unrecognized value is rejected with 400 unsupported_api_version.
Path Parameters
Response
SSE event stream; each event: name is the event type and data: is its JSON payload.
- Option 1
- Option 2
Server-sent event stream. While the turn runs, each progress frame has an id: (the event's sequence number — send it back as the Last-Event-ID header to resume), an event: name equal to the QueryEvent type (e.g. response.step), and that QueryEvent as its JSON data:. When the turn finishes, a final frame named event: query is sent — no id:, with the full Query document as data:.
response.created
response.output_text.delta
response.failed / response.cancelled
response.trace
response.step
response.step (running/completed/failed), response.synthesis (completed)
response.step
response.step
response.step
response.step
response.step
response.turn_rollup
response.turn_rollup
response.turn_rollup
response.turn_rollup
response.turn_rollup
response.turn_rollup
response.turn_rollup
response.synthesis
response.synthesis
response.synthesis
response.synthesis
response.synthesis
response.synthesis
response.synthesis