TOtower

Search runs

Changed on

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

get/runs

Request

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 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.

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/SearchRunsResponse.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