Returns
Returns a list of Run objects.Example
Parameters
string | list[string]
The ID or IDs of the product(s) to filter runs by.
string | list[string]
The ID or IDs of the version(s) to filter runs by.
string | list[string]
The ID or IDs of the run(s) to retrieve.
string | list[string]
The label or labels to filter runs by.
string | list[string]
Filter runs by status. Valid values are
RUNNING, COMPLETED, FAILED and CANCELLED. Other string
values are sent to the API unchanged, so values added in newer API versions can be used; the API
rejects invalid ones.str | int
Filter runs created at or after this timestamp. Accepts an ISO 8601 string (e.g.
'2024-01-01T00:00:00Z')
or a Unix timestamp in seconds.str | int
Filter runs created at or before this timestamp. Accepts an ISO 8601 string (e.g.
'2024-12-31T23:59:59Z')
or a Unix timestamp in seconds.string
Sort runs by creation date. Valid values are
"asc" and "desc".int
Number of runs to skip before collecting results. Use it for pagination.
int
Maximum number of runs to return in a single request.
string
Free text that matches either the label of a run (case-insensitive, anywhere in the label) or its
number. The number is accepted with or without a leading
#, so both 42 and #42 find run 42.At least one of
product_ids, version_ids or ids must be passed. The other filters narrow the
result but do not satisfy this requirement on their own.