Skip to main content
GET
Stream run events

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Headers

last-event-id
string

Path Parameters

run_id
string
required

Canonical run UUID. Normal callers need access to the run owner and project.runs.read. A bound eval runtime may instead read its authorized direct agent child.

Minimum string length: 1

Query Parameters

event_representation

Omit for released run frames. Use run-events-v1 for target CloudEvents, canonical-v1 for canonical read members, or ag-ui for public Agent events and native Task/Workflow lifecycle frames.

Available options:
run-events-v1,
ag-ui

Response

Run event stream

Server-sent event frames. Without event_representation, each data field contains a JSON RunStreamFrame. With run-events-v1, each data field contains one target CloudEvent. With ag-ui, Agent runs expose one receipt-backed public AG-UI event per frame; Task and Workflow runs expose native AG-UI lifecycle frames. With canonical-v1, each data field contains a complete validated canonical, legacy or transient stream member.