latestOpenAPI 3.1.02026-08-20118232229.3 KB

0e42b0fb26d9

Generate run statistics

Generates statistics about runs over a specified time period.

get/stats/runs

Query parameters

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 required

Start date and time for statistics (inclusive)

Start date and time for statistics (inclusive)

end_atstring date-time required

End date and time for statistics (inclusive)

End date and time for statistics (inclusive)

timezonestring

Timezone for the statistics (e.g., 'Europe/Berlin'). Defaults to UTC.

Timezone for the statistics (e.g., 'Europe/Berlin'). Defaults to UTC.

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