Skip to main content
POST
TypeScript

Yetkilendirmeler

Authorization
string
header
gerekli

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

Scopes

developer:manage_builds

Başlıklar

Idempotency-Key
string

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

Maximum string length: 255
Örnek:

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

Api-Version-Date
string

Pins the request to a dated API version.

Örnek:

"2026-11-17"

Yol Parametreleri

id
string
gerekli

The app to deploy, prefixed app_.

Gövde

application/json
draft
boolean

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

Örnek:

false

Yanıt

deployment started

app_id
string
gerekli

The app being deployed, prefixed app_.

Örnek:

"app_xxxxxxxxxxxxxx"

build_id
string | null
gerekli

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

Örnek:

null

draft
boolean
gerekli

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

Örnek:

false

error
string | null
gerekli

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

Örnek:

null

estimated_duration_ms
integer | null
gerekli

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

Örnek:

150000

estimated_remaining_ms
integer | null
gerekli

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

Örnek:

91000

finished_at
integer | null
gerekli

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

Örnek:

null

phase
enum<string> | null
gerekli

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.

Mevcut seçenekler:
install,
build,
typecheck,
upload_build,
upload_source,
process_archive,
create_build,
promote,
null
Örnek:

"process_archive"

progress
number | null
gerekli

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

Örnek:

0.39

started_at
integer | null
gerekli

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

Örnek:

1767268800000

status
enum<string>
gerekli

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.

Mevcut seçenekler:
published,
unpublished,
publishing,
failed,
no_source
Örnek:

"publishing"

url
string | null
gerekli

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

Örnek:

null