Deploy App
Builds the app’s current source and ships it. Returns the run it started, so the caller can render progress from this response and then follow it on the app’s deployment field. Only one deployment runs per app at a time — calling this while one is in flight reports that run rather than starting a second, and calling it with nothing to publish reports that instead of starting one.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-08-13"
Path Parameters
The app to deploy, prefixed app_.
Body
Upload the build without making it live. Defaults to false, which deploys and promotes in one step.
false
Response
deployment started
The app being deployed, prefixed app_.
"app_xxxxxxxxxxxxxx"
The build the deployment produced, prefixed abld_, or null until it succeeds.
Whether the running or last deployment uploaded a build without making it live.
false
Why the deployment failed, or null when it did not.
How long this deployment is expected to take in total, estimated from previous runs.
150000
How much longer the deployment is expected to take. Held above zero until it actually finishes.
91000
When the deployment ended, in milliseconds since the epoch, or null while it is still running.
The stage a running deployment has reached, or null when none is running. Later phases dominate the wall clock: process_archive waits on the upload pipeline and promote waits for the build to go live.
install, build, typecheck, upload_build, upload_source, process_archive, create_build, promote, null "process_archive"
Fraction of the deployment estimated to be complete, from 0 to 1. Stops just short of 1 until the run ends.
0.39
When the deployment began, in milliseconds since the epoch, or null when none has run.
1767268800000
Whether the app has anything to publish, and what a publish in flight is doing. unpublished means publishing would ship something new; no_source means the sandbox holds no copy of this app, so there is nothing to publish from.
published, unpublished, publishing, failed, no_source "publishing"
Where the deployed site is served, or null unless the deployment went live.

