Skip to main content
POST
Create Build
Add a new build to an existing app. By default the new build is promoted to active; pass set_as_current: false to leave the active build unchanged. Call POST /apps/upload-url first to obtain an s3_key.

Path parameters

integer
required
App ID.

Request body

The build name field is name on this endpoint. (When creating an app’s first build via POST /apps/create the equivalent field is build_name.)
string
required
Unique within the app. Max 255 chars.
string
required
From POST /apps/upload-url. Must belong to your company.
integer
required
Bytes uploaded.
string
Used to preserve the file extension.
boolean
Default true. Set false to upload a build without affecting running tests; promote it later with Set Active Build.

Response

Returns { message, build, app }. app.current_build reflects the new active build when set_as_current is true. build.arch is "arm64" / "x86_64" / "universal" for Android (auto-detected from the binary) and null for iOS.

Errors