List runs

GET

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

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 app deployment ID.

usernamestringOptional

Filter runs initiated by the specified user (username).

run_idstringOptional

Filter specific run by run ID.

statusstringOptional

Filter jobs by status, such as COMPLETE, RUNNING, or FAILED.

output_repostringOptional

Filter runs by the output repo.

from_timestampintegerOptional

Filter runs starting from this timestamp. Defaults to one week before the current time.

to_timestampintegerOptional

Filter runs up to this timestamp. Defaults to the current time.

limitintegerOptional

Number of results to return.

file_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, such as ASCENDING or DESCENDING.

Allowed values: ASCENDINGDESCENDING

Response

A list of all runs.

runslist of objectsOptional