Access tokens1

Account links1

Accounts11

Ad Campaigns9

Ad Groups10

Ad reports1

Ads8

Affiliates10

Ai chats5

API Keys7

Api Logs1

App Builds4

Apps9

Audiences5

Authorized users4

Bounties7

Bounty Submissions5

Cards6

Chat channels3

Checkout Configurations4

Companies5

Company token transactions3

Confirmation Tokens2

Course chapters5

Course lesson interactions2

Course lessons8

Course students2

Courses5

Deposits1

Dispute alerts2

Disputes8

Dm channels5

Dm members5

Entries4

Events4

Experiences8

Exports3

Fee markups3

Files4

Forum posts4

Forums3

Identity profiles4

Invoices9

Leads4

Ledger accounts1

Ledgers3

Media2

Members3

Memberships12

Messages5

Notifications6

Partners6

Payment Method Domains5

Payment methods3

Payments10

Payout accounts1

Payout methods2

Payouts10

People2

Permissions1

Plans6

Products7

Promo Codes6

Reactions4

Recommended Actions4

Refunds2

Resolution Center Cases11

Reviews2

Setup intents3

Setup Intents2

Shipments4

Social Accounts6

Stats5

Support channels3

Swaps4

Team Members5

Topups1

Transfers4

Users18

Verifications4

Webhooks10

Webhooks

Accounts1

Ad Campaigns1

Cards13

Course lesson interactions1

Deposits1

Dispute alerts1

Disputes2

Entries4

Exports2

Invoices5

Ledger accounts1

Members1

Memberships4

Messages1

Payments6

Payout accounts1

Payouts4

Plans3

Products5

Reactions1

Refunds2

Resolution Center Cases3

Setup intents3

Shipments2

Swaps1

Transfers3

Verifications2

App Builds

Promote App Build

Promotes a draft or approved app build to production so it becomes the active version served to users. Draft builds enter review first.

post/app_builds/{id}/promote

Headers

Idempotency-Keystring

Example:d9105228-4a08-46b1-8b91-42fed586d383

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

Response

app build promotion started

checksumstring required

Client-generated checksum of the build file, used to verify file integrity.

created_atstring required

When the build was uploaded, as an ISO 8601 timestamp.

file_urlstring nullable required

URL to download the uploaded build artifact.

idstring required

App build ID, prefixed abld_.

is_productionboolean required

Whether this build is the currently active production build for its platform.

platform'ios' | 'android' | 'web' required

The target platform for this build.

review_messagestring nullable required

Feedback from the reviewer explaining a rejection, or null if the build has not been reviewed or was approved.

source_urlstring nullable required

URL to download the compressed source code archive that produced this build, or null when the build was uploaded without a source archive.

status'draft' | 'pending' | 'approved' | 'rejected' required

The build's review status.

supported_app_view_typesstring[] required

Example response

{
  "checksum": "xxxxxxxxxxxxxxx",
  "created_at": "2026-01-01T12:00:00.000Z",
  "file_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "id": "apbu_xxxxxxxxxxxxxx",
  "platform": "ios",
  "review_message": "The hub view crashes on launch when the member has no active membership. Fix and resubmit.",
  "source_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "rejected",
  "supported_app_view_types": [
    "hub"
  ]
}

Changes

Changed in 4 of the 41 revisions of this API.21620

Aug 12, 2026ae20b30817de1See the full diff
- ○
  added the non-success response with the status 409
  response-non-success-status-added
Aug 7, 2026f1020c3ecda44See the full diff
- ○
  added the optional property error/code to the response with the 400 status
  response-optional-property-added
- ○
  added the optional property error/code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property error/code to the response with the 403 status
  response-optional-property-added
- ○
  added the optional property error/code to the response with the 404 status
  response-optional-property-added
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 31, 2026099fdc3be4227See the full diff
- ●
  added the new analytics enum value to the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new dash enum value to the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new dashboard enum value to the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new discover enum value to the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new hub enum value to the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new openapi enum value to the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new skills enum value to the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 26, 202660bbb4a6ffbc2915See the full diff
- ▲
  the response property file_url became nullable for the status 200
  response-property-became-nullable
- ▲
  the created_at response's property type/format changed from string/date-time to string/ for status 200
  response-property-type-changed
- ●
  deleted the path request parameter id
  request-parameter-removed
- ●
  removed the optional property error/code from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property error/code from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property error/code from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property error/code from the response with the 404 status
  response-optional-property-removed
- ●
  removed the optional property error/param from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property error/param from the response with the 401 status
  response-optional-property-removed
- ●
  removed the optional property error/param from the response with the 403 status
  response-optional-property-removed
- ●
  removed the optional property error/param from the response with the 404 status
  response-optional-property-removed
- ○
  api tag App Builds added
  api-tag-added
- ○
  api tag App builds removed
  api-tag-removed
- ○
  added the new optional header request parameter Api-Version-Date to all path's operations
  new-optional-request-default-parameter-to-existing-path
- ○
  added the new optional header request parameter Idempotency-Key
  new-optional-request-parameter
- ○
  removed the non-success response with the status 422
  response-non-success-status-removed
- ○
  removed the non-success response with the status 429
  response-non-success-status-removed
- ○
  removed the non-success response with the status 500
  response-non-success-status-removed
- ○
  removed the analytics enum value from the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the dash enum value from the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the dashboard enum value from the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the discover enum value from the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the hub enum value from the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the openapi enum value from the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the skills enum value from the supported_app_view_types/items/ response property for the response status 200
  response-property-enum-value-removed
- ○
  added the required property source_url to the response with the 200 status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history