NylorunDocsBeta
Runtime APIAgentsTriggers

Follow the Tenant's runs

GET
/v1/runs/stream

Server-sent events, one event: run per run of any Agent's triggers, with its cursor as id, from the cursor on (?cursor= or Last-Event-ID; none reads from the oldest run the stream keeps, 7 days). The data is {cursor, run}: the run as the Agent's runs list it, with its Agent and its trigger's origin and title. A run may arrive twice: drop a runId you have seen. A cursor from before the Tenant's reset is refused (cursor_expired): read again without one. A : keepalive comment every 15 seconds.

Authorization

applicationKey
headerAuthorizationBearer <token>

An application key of the Tenant (PUT /v1/tenant/keys/{keyId}), or Studio's key, derived from the admin key. With Nylorun-Subject and Nylorun-Scopes, it acts for that person, narrowed to those scopes. Never accepted from a browser (Origin).

Query Parameters

cursor?string

The cursor of the last run read: the stream goes on after it

Header Parameters

Nylorun-Protocol*string

The protocol version, 18

Response Body

The runs

text/event-stream
curl -X GET "https://example.com/v1/runs/stream" \  -H "Nylorun-Protocol: string"
Empty