TOtower

Create app

Changed on

Create a new app in the current account.

post/apps

Request

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.

max_concurrent_runsinteger nullable

The maximum number of runs that can be dispatched at once for this app. Value of 0 means no limit.

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 time limit in seconds for each run attempt, measured from dispatch to a runner and including provisioning and setup. The run is cancelled when the limit is reached. Zero means no timeout.

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

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 new optional request property

    • info

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

    • info

      added the required property / to the response with the status