Skip to main content
POST
TypeScript

Autorisaties

Authorization
string
header
vereist

Only available to a signed-in whop.com session. API keys, access tokens, and OAuth tokens are not accepted.

Scopes

developer:manage_builds

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Voorbeeld:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Voorbeeld:

"2026-11-17"

Padparameters

id
string
vereist

The app to deploy, prefixed app_.

Body

application/json
draft
boolean

Upload the build without making it live. Defaults to false, which deploys and promotes in one step.

Voorbeeld:

false

Respons

deployment started

app_id
string
vereist

The app being deployed, prefixed app_.

Voorbeeld:

"app_xxxxxxxxxxxxxx"

build_id
string | null
vereist

The build the deployment produced, prefixed abld_, or null until it succeeds.

Voorbeeld:

null

draft
boolean
vereist

Whether the running or last deployment uploaded a build without making it live.

Voorbeeld:

false

error
string | null
vereist

Why the deployment failed, or null when it did not.

Voorbeeld:

null

estimated_duration_ms
integer | null
vereist

How long this deployment is expected to take in total, estimated from previous runs.

Voorbeeld:

150000

estimated_remaining_ms
integer | null
vereist

How much longer the deployment is expected to take. Held above zero until it actually finishes.

Voorbeeld:

91000

finished_at
integer | null
vereist

When the deployment ended, in milliseconds since the epoch, or null while it is still running.

Voorbeeld:

null

phase
enum<string> | null
vereist

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.

Beschikbare opties:
install,
build,
typecheck,
upload_build,
upload_source,
process_archive,
create_build,
promote,
null
Voorbeeld:

"process_archive"

progress
number | null
vereist

Fraction of the deployment estimated to be complete, from 0 to 1. Stops just short of 1 until the run ends.

Voorbeeld:

0.39

started_at
integer | null
vereist

When the deployment began, in milliseconds since the epoch, or null when none has run.

Voorbeeld:

1767268800000

status
enum<string>
vereist

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.

Beschikbare opties:
published,
unpublished,
publishing,
failed,
no_source
Voorbeeld:

"publishing"

url
string | null
vereist

Where the deployed site is served, or null unless the deployment went live.

Voorbeeld:

null