Skip to main content
POST
TypeScript

인증

Authorization
string
header
필수

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

Scopes

developer:manage_builds

헤더

Idempotency-Key
string

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

Maximum string length: 255
예시:

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

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

경로 매개변수

id
string
필수

The app to deploy, prefixed app_.

본문

application/json
draft
boolean

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

예시:

false

응답

deployment started

app_id
string
필수

The app being deployed, prefixed app_.

예시:

"app_xxxxxxxxxxxxxx"

build_id
string | null
필수

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

예시:

null

draft
boolean
필수

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

예시:

false

error
string | null
필수

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

예시:

null

estimated_duration_ms
integer | null
필수

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

예시:

150000

estimated_remaining_ms
integer | null
필수

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

예시:

91000

finished_at
integer | null
필수

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

예시:

null

phase
enum<string> | null
필수

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"

progress
number | null
필수

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

예시:

0.39

started_at
integer | null
필수

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

예시:

1767268800000

status
enum<string>
필수

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"

url
string | null
필수

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

예시:

null