Skip to main content
GET
List Pipeline Runs
Required scope: agent_runs:read. Prefer this endpoint for large pipeline dashboards; load progress/tasks only for runs you need to inspect.

Parameters

Filters can be combined. Runs without matching source metadata are excluded. Use IDs returned by your own API calls; the UUIDs below are examples.

Response example

id is the run UUID; pass it as run_id to progress, tasks, or delivery receipts. status_message provides persisted status details. updated_at may be null for historical rows whose update time is unknown. trigger_info may be null for manually started runs. agent_id may be null if the originating agent is unavailable. Fetch every next_cursor until null. On subsequent polls, restart without a cursor and overlap your updated_from watermark. See polling and error handling. A missing permission returns a structured 403 naming agent_runs:read; retrying with the same key cannot grant access.