Update app

Changed on Oct 6, 2026

Update an app in the currently authenticated account.

put/apps/{name}

Request

Base URL
https://api.tower.dev/v1
Auth
- HTTP bearer
- or API key in header X-API-Key
TypeScript
https://skmtc.dev/tower/apis/tower-api/docs/apps/:name/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

namestring required

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.

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.

max_concurrent_runsinteger nullable

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

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