Skip to main content
POST
Create application build

Path Parameters

applicationShortId
string
required
Pattern: ^app(-.+_.+|_.+)$

Body

application/json

Request body for creating an application build after uploading via presigned URL

platform
enum<string>
required

Mobile platform for application builds

Available options:
ios,
android
buildToken
string
required

The buildToken returned by application_build_upload_url, after the build file was uploaded (HTTP PUT) to its uploadUrl.

version
string

Optional version label for the build (e.g. '1.2.3', 'v2.0.0-beta'). If omitted, QA.tech attempts to extract the version from the APK/IPA metadata.

buildNumber
string

Optional build number (e.g. '42', '1234'). This is the CFBundleVersion for iOS or versionCode for Android. If omitted, QA.tech attempts to extract it from the APK/IPA metadata.

projectShortId
string

Target a specific project by its prefixed short ID (proj-slug_shortId or proj_shortId), as returned by the projects API. Required for organization-scoped API keys; project-scoped keys may only pass their own project's short ID.

Pattern: ^proj(-.+_.+|_.+)$

Response

200 - application/json

The request has succeeded.

Response with created application build metadata. Use applicationBuildShortId as environment.applicationBuildShortId in start_run_with_test_cases / start_run_with_test_plan / create_chat overrides.

applicationBuildShortId
string
required

Short ID of the created build. Use as environment.applicationBuildShortId in a start_run_with_test_cases / start_run_with_test_plan applications[] override or a create_chat applicationOverrides[] override.

Pattern: ^build(-.+_.+|_.+)$
platform
enum<string>
required

Mobile platform for application builds

Available options:
ios,
android
fileName
string
required
fileSizeBytes
integer<int64>
required
version
string

Build version string (e.g. '1.2.3'), extracted from app metadata or provided during upload.

buildNumber
string

Build number (e.g. '42'), extracted from app metadata or provided during upload. This is CFBundleVersion for iOS or versionCode for Android.