latestOpenAPI 3.1.02026-08-20118232229.3 KB

0e42b0fb26d9

Update app

Update an app in the currently authenticated account.

put/apps/{name}

Path parameters

namestring required

The name of the App to update.

The name of the App to update.

Headers

X-Tower-Request-Numberinteger

Optional account-scoped monotonic sequence token used to reject out-of-order writes. See the fence documentation for the acceptance window and retry behavior.

Optional account-scoped monotonic sequence token used to reject out-of-order writes. See the fence documentation for the acceptance window and retry behavior.

Request body

$schemastring uri

A URL to the JSON Schema for this object.

descriptionstring nullable

Deprecated: use short_description instead.

is_externally_accessibleboolean nullable

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

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 nullable

New description for the app.

statusstring nullable

New status for the App

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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