v2
latestOpenAPI 3.1.02026-08-06276982.8 KBList runs
Return a list of runs. Use query parameters to filter results.
Query parameters
Filter runs by app ID.
Filter runs by app name.
Filter runs by deployment ID.
Filter runs initiated by the specified user (username).
Filter specific run by run ID.
Filter jobs by status, such as COMPLETE, RUNNING, or FAILED.
Filter runs by the run's output workspace. By default, all runs across all workspaces you have access to are returned, use this query parameter to filter by specific workspace names. You must have access to the named workspaces.
Filter runs starting from this timestamp. Timestamp in Unix time in seconds. Defaults to 24 hours before the current time.
Filter runs up to this timestamp. Timestamp in Unix time in seconds. Defaults to the current time.
Number of results to return.
Offset of the first result to return.
Field to sort results by.
Order of sorting, such as ASCENDING or DESCENDING.
Headers
Bearer HTTP authentication.
Typically your organization ID. See Authorization and context identification for details.
Response
A list of all runs.