TOtower

List runs

Changed on

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

Request

Path parameters

namestring required

The name of the app to fetch runs for.

Query parameters

pageinteger

The page number to fetch.

page_sizeinteger

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.

start_atstring date-time

Filter runs scheduled after or at this datetime (inclusive)

end_atstring date-time

Filter runs scheduled before or at this datetime (inclusive)

environmentstring

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"
}

Changes

  • d4eb8af936b9Revision changes
    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

  • 40c3fdc951e3Revision changes
    • info

      added the required property // to the response with the status