List visible runs
GET/api/v1/runs
Returns runs only for jobs visible to the authenticated identity, with optional status and UTC time bounds.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Optional repeated run statuses: PENDING, RUNNING, SUCCEEDED, FAILED, CANCEL_REQUESTED, CANCELLED, or RETRY_SCHEDULED.
Inclusive lower timestamp bound in UTC ISO-8601 date-time format.
Exclusive upper timestamp bound in UTC ISO-8601 date-time format.
Zero-based page number.
Requested page size, clamped to the range 1 through 200.
Responses
Section titled “Responses”Visible runs returned
Zero-based page of resource results.
object
Results in this page.
Public durable run state and attempt lineage. Lease tokens and resolved datasource security are never exposed.
object
One-based attempt number.
Earliest database time at which this attempt is eligible for claim.
Mode-specific warning about sink state after cancellation.
Incremental watermark committed only by successful finalization.
Run creation timestamp in UTC.
Elapsed execution time in milliseconds when reported.
Credential-redacted failure detail.
Worker identity assigned after claim.
Terminal completion timestamp in UTC.
Most recent successful worker heartbeat in UTC.
Run attempt identifier.
Owning job definition identifier.
Current claim expiry timestamp in UTC.
Previous attempt in the retry chain.
Rows processed by this attempt when reported.
Execution start timestamp in UTC.
Durable lifecycle state.
Zero-based page number.
Effective page size, from 1 through 200.
Total matching resources across all pages.
The request is malformed or fails validation.
RFC 7807 problem response. Dynamic detail text is credential-redacted.
object
Authentication is required or credentials are invalid.
RFC 7807 problem response. Dynamic detail text is credential-redacted.