latestOpenAPI 3.1.02026-08-20118232229.3 KB

0e42b0fb26d9

Create app

Create a new app in the current account.

post/apps

Request body

$schemastring uri

A URL to the JSON Schema for this object.

is_externally_accessibleboolean

Indicates that web traffic should be routed to this app and that its runs should get a hostname assigned to it.

namestring required

The name of the app.

pending_timeoutinteger nullable

The amount of time in seconds that runs of this app can stay in pending state before being marked as failed.

running_timeoutinteger nullable

The amount of time in seconds that runs of this app can stay in running state before being marked as failed.

short_descriptionstring

A description of the app.

slugstring

The slug of the app. Legacy CLI will send it but we don't need it.

subdomainstring nullable

The subdomain this app is accessible under. Requires is_externally_accessible to be true.

Example request

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

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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