Runs

List Run Events

Read the durable event log for a run: started, node progress, and completion markers.

curl -X GET 'https://api.edgaze.ai/v1/runs/7c9e6679-7425-40de-944b-e07fc1f90ae7/events' \
  -H 'Authorization: Bearer edgaze_sk_live_YOUR_KEY'

GEThttps://api.edgaze.ai/v1/runs/{run_id}/events

Overview#

Returns the durable, ordered event log for a run: `run.started`, `node.completed`, `run.completed`, and related markers. Each event has a monotonic sequence number and ISO timestamp.

Use alongside GET /runs/{id} when you need step-level visibility: for example, showing progress in a dashboard or debugging which node failed.

Fetch after POST /runs while polling status. Events are append-only for the life of the run. There is no limit query parameter: the full log is returned.

Authorization#

run:read

Parameters#

Headers

Authorizationstringheaderrequired

Bearer token with run:read scope.

Example: Bearer edgaze_sk_live_…

Path parameters

run_idstringpathrequired

UUID returned from POST /runs.

Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

Response#

Example payloads are in the request/response panel above.

Edge cases#

Full event log

The endpoint returns the complete ordered event log for the run.

Use with polling

Combine GET /runs/{id} for outputs with GET /runs/{id}/events for step-by-step progress.