latestOpenAPI 3.1.02026-08-20118232229.3 KB

0e42b0fb26d9

Search runs

Search, filter, and list runs across all of the apps in your account.

get/runs

Query parameters

pageinteger

The page number to fetch.

The page number to fetch.

page_sizeinteger

The number of records to fetch on each page.

The number of records to fetch on each page.

statusstring[]

Filter runs by status(es). Define multiple with a comma-separated list. Supplying none will return all statuses.

Filter runs by status(es). Define multiple with a comma-separated list. Supplying none will return all statuses.

start_atstring date-time

Filter runs scheduled after this datetime (inclusive). Provide timestamps in ISO-8601 format.

Filter runs scheduled after this datetime (inclusive). Provide timestamps in ISO-8601 format.

end_atstring date-time

Filter runs scheduled before or at this datetime (inclusive). Provide timestamps in ISO-8601 format.

Filter runs scheduled before or at this datetime (inclusive). Provide timestamps in ISO-8601 format.

environmentstring

Filter runs by environment. If not provided, all environments will be included.

Filter runs by environment. If not provided, all environments will be included.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.tower.dev/v1/schemas/SearchRunsResponse.json"
}