Sign in
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://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/zip/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "rejected",
  "supported_app_view_types": [
    "hub"
  ]
}

Changes

Changed in 66 of the 74 revisions of this API.51387

  • 78e1ed7366cd1See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 73dd0533cd811See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 86b97292852d1See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • c1dceb26e5051See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 7fcefabddb0a1See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 140d015b99661See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 35edb053220a1See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ac2b9b1c6a001See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • a88353507eac1See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 51933d70d7f51See the full diff
    • ○

      the security scope developer:manage_builds was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

Of the 74 revisions, 1 has no diff computed.