latestOpenAPI 3.1.02026-08-20118232229.3 KB

0e42b0fb26d9

List apps

Get all the apps for the current account.

get/apps

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.

tag_filterstring

The tag query to filter apps by. Provide a serialized TagFilter as the value for the parameter.

Example:tag_filter={"op":"eq","name":"foo","value":"bar"}

The tag query to filter apps by. Provide a serialized TagFilter as the value for the parameter.

querystring

The search query to filter apps by.

The search query to filter apps by.

num_runsinteger

Number of recent runs to fetch (-1 for all runs, defaults to 20)

Number of recent runs to fetch (-1 for all runs, defaults to 20)

sort'most_recent_run' | 'a_to_z' | 'created_at' | 'updated_at'

Sort order for the results.

Sort order for the results.

filter'disabled' | 'running' | 'withWarning' | 'healthy' | 'scheduled'

Filter to see apps with certain statuses.

Filter to see apps with certain statuses.

environmentstring

The environment to filter the apps by. If not provided, apps for all environments will be returned.

The environment to filter the apps by. If not provided, apps for all environments will be returned.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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