Skip to navigation

Managed Run Event Stream

View as Markdown

Replay and stream durable run events; resume using after or Last-Event-ID.

A terminal run event ends the stream. Idle streams may also close: callers can resume from their last delivered event without restarting the run.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_idstringRequired
run_idstringRequired

Headers

Last-Event-IDstring or nullOptional

Query parameters

afterstringOptionalDefaults to 0

Response

Successful Response
createdAtstring
eventTypestring
idstring
payloadmap from strings to any

Fields specific to eventType; open by design. Documented shapes: run.failed carries error, a RunError (code, message, recoverable). run.tool_call.failed may carry error with code and message, where code is one of effect_unconfirmed, approval_denied, access_changed; the action did not run, or its outcome could not be confirmed and it was not repeated. run.paused carries reason: credits_required (credits or the agent spending cap ran out; the run resumes once funded) or admission_deferred (the run is waiting to be admitted and resumes on its own).

sequenceinteger

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error