trickroom / Docs
Sign in

Stream durable events with cursor replay

SSE event: events contains JSON {data: Event[]} with up to 200 rows. Its id is the last sequence. Deduplicate by sequence and reconnect from the last applied cursor. Keepalive comments arrive after idle reads (30 seconds). A stream-error event contains {code} and closes the stream. Authorization is rechecked before each batch. Initial failures are JSON HTTP errors; failures after streaming starts cannot change HTTP status.

GET/v1/jobs/{id}/events/stream

Authorization

Authorizationstringrequired

Bearer tak_… — an application API key. Keep it on your backend; all resources are scoped to that application.

Create an application key →

Path parameters

idstringrequired

Min length: 1

Query parameters

afterinteger

Last applied per-job sequence.

Default: 0 · Minimum: 0 · Maximum: 2147483647

Response

200Stream durable events with cursor replay
X-Request-Idstring

Server-generated request identifier for logs and support.

text/event-stream

valuestring
4XX400 invalid input; 401 missing/revoked credentials; 403 disallowed operation/application; 404 missing or inaccessible resource; 409 conflicting submission/version/state; 413 body too large; 415 unsupported content type. Inspect error.code, not message text.
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired
Object fields
codestringrequired
messagestringrequired
request_idstringrequired

Additional keys: any

5XX500 unexpected failure or 503 unavailable dependency. A failed response does not prove that a submission was not committed. Retry job/flow admission with the same key and body.
X-Request-Idstring

Server-generated request identifier for logs and support.

application/json

errorobjectrequired
Object fields
codestringrequired
messagestringrequired
request_idstringrequired

Additional keys: any