Sign in
latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

App Builds

Create App Build

Uploads a new build artifact for an app. Upload the file first (POST /files or a direct upload), then reference it here; iOS and Android take a .zip bundle, web takes a JavaScript file or a .zip archive of the hosted site.

post/app_builds

Headers

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

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

Request body

ai_prompt_idstring

The AI prompt that generated this build, if applicable.

app_idstring

The app to create the build for, prefixed app_. Defaults to the app behind the presented credential.

checksumstring required

A client-generated checksum of the build file, used to verify file integrity when unpacked.

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

The target platform for the build.

supported_app_view_typesstring[]

The view types this build supports. Only list the ones its code implements.

Example request

{
  "ai_prompt_id": "prmt_xxxxxxxxxxxxxx",
  "app_id": "app_xxxxxxxxxxxxxx",
  "attachment": {
    "direct_upload_id": "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "id": "file_xxxxxxxxxxxxxx"
  },
  "checksum": "xxxxxxxxxxxxxxx",
  "platform": "web",
  "source_attachment": {
    "direct_upload_id": "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "id": "file_xxxxxxxxxxxxxx"
  },
  "supported_app_view_types": [
    "hub"
  ]
}

Response

app build created

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://assets-2-rough.whop.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://assets-2-rough.whop.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "rejected",
  "supported_app_view_types": [
    "hub"
  ]
}