GET /runs/:id/events

GET

/runs/{id}/events

curl --request GET \
  --url https://example.com/runs/example/events

NDJSON event tail. ?follow=1 live-tails (the default while the run is non-terminal); ?limit=N requests a bounded non-streaming read of at most N events and implies follow=false — the response closes after the page, so agents can poll for liveness without holding a stream open (warren-17c1). ?since=<seq> pages forward from a prior read.

Parameters

Path Parameters

id

required

string

Responses

200

Successful response.

default

Error response (see src/core/errors.ts).

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

hint

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "hint": "example"
  }
}