sessions

Stream Session

SSE tail of the session's event stream, by seq cursor.

Live view and replay are the same endpoint: pass ?cursor= (or the SSE Last-Event-ID header on reconnect) to resume. Emits:

  • event: message frames (id: = the row's seq; data = run message)
  • event: turn frames whenever a turn's status changes (the composer's end-of-turn signal)
  • event: live frames while a text/thinking block streams on the ACTIVE turn (token-level streaming, AI Elements spec PR2d): the block so far whenever it grew or changed, text: null once it landed — emitted BEFORE the rows of the same poll so a landed row always follows its own clear
  • : ping comments to keep intermediaries from buffering.

Deliberately DB-tail polling (~400ms) decoupled from the intake POST: refresh-safe, and how a scheduled turn is watched live. The overlap re-read is time-based and generous; the client dedupes by seq.

get/sessions/{session_id}/stream

Request

  • Base URL: https://api.nanocorp.so (the document declares no server; this is the origin it was published from)
  • URL: https://api.nanocorp.so/sessions/{session_id}/stream
  • Auth: HTTP bearer

Path parameters

session_idstring uuid required

Query parameters

cursorinteger nullable

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 39 revisions of this API.