Sign in
latestOpenAPI 3.1.02026-08-20118232229.3 KB

0e42b0fb26d9

List runs

Generates a list of all the runs for a given app. The list is paginated based on the query string parameters passed in.

get/apps/{name}/runs

Path parameters

namestring required

The name of the app to fetch runs for.

The name of the app to fetch runs for.

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 or at this datetime (inclusive)

Filter runs scheduled after or at this datetime (inclusive)

end_atstring date-time

Filter runs scheduled before or at this datetime (inclusive)

Filter runs scheduled before or at this datetime (inclusive)

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/ListRunsResponse.json"
}