agent

Stream persisted agent run events

Replays events whose index is greater than the cursor, then follows committed events until the run reaches a terminal state. Reconnecting with the last received index is lossless and duplicate-safe.

get/agent/runs/{run_id}/events/stream

Path parameters

run_idstring required

Query parameters

afterinteger

Last persisted event index received by the client. Takes precedence over Last-Event-ID.

principal_idstring

Scope by principal. If omitted, only a run with no principal (principal_id is null) is addressed; a run whose principal differs yields 404.

Headers

Last-Event-IDstring

SSE reconnect cursor used when the after query parameter is omitted.

Response

Indexed AG-UI Server-Sent Events. Keepalive comments do not advance the cursor.

Changes