List runs

GET

Return a list of runs. Use query parameters to filter.

Headers

IB-ContextstringOptional

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See Authorization and context identification for details.

Query parameters

app_idstringOptional

Filter runs by app ID.

app_namestringOptional

Filter runs by app name.

deployment_idstringOptional

Filter runs by deployment ID.

usernamestringOptional

Filter runs initiated by the specified user (username).

run_idstringOptional

Filter specific run by run ID.

statusenumOptional

Filter runs by status.

output_repostringOptional

Filter runs by the output repo.

from_timestampintegerOptional

Filter runs starting from this Unix timestamp (in seconds). Defaults to one week before the current time.

to_timestampintegerOptional

Filter runs up to this Unix timestamp (in seconds). Defaults to the current time.

limitintegerOptional

Number of results to return.

offsetintegerOptional

Offset of the first result to return.

sort_by"start_timestamp" or "status"Optional

Field to sort results by.

Allowed values: start_timestampstatus
order"ASCENDING" or "DESCENDING"Optional

Order of sorting.

Allowed values: ASCENDINGDESCENDING

Response

A list of all runs.

runslist of objectsOptional