Deployments.ai Docs
Runtime

Tail a run timeline

GET /v1/threads/{threadId}/stream · SDK readThreadStream · CLI deployments run tail

GET
/v1/threads/{threadId}/stream

Requires read.

Authorization

streamSessionBearer
headerAuthorizationBearer <token>

Short-lived bearer token scoped to one thread stream.

Path Parameters

threadId*string
Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Query Parameters

cursor?string

Durable stream cursor from a previous read.

Length1 <= length
live?string

Live mode: long-poll waits for the next events; sse holds a text/event-stream open that the server closes periodically, so reconnect from the last control offset. Omit for a catch-up read.

Value in"long-poll""sse"
offset?string

Durable stream byte offset.

Length1 <= length

Response Body

RuntimeStreamResponse

  1. response
[index: integer]?null|boolean|number|string|array<unknown>|
curl -X GET "https://example.com/v1/threads/string/stream"
[  null]