Skip to main content
The builds command manages app builds, including uploads, listing, and TestFlight distribution.

​
Usage

asc builds <subcommand> [flags]

​
Subcommands

​
Upload builds

Upload IPA files to App Store Connect: 
asc builds upload --app APP_ID --file /path/to/MyApp.ipa

​
List builds

List all builds for an app: 
asc builds list --app APP_ID
asc builds list --app APP_ID --sort -uploadedDate
asc builds list --app APP_ID --filter "processingState==VALID"

​
Get build details

Retrieve details for a specific build: 
asc builds get --build BUILD_ID
asc builds latest --app APP_ID

​
Distribute to TestFlight

Add builds to beta groups: 
asc builds add-groups --build BUILD_ID --group "External Testers"
asc builds add-groups --build BUILD_ID --group "GROUP1,GROUP2"

​
Expire builds

Expire builds from TestFlight: 
asc builds expire --build BUILD_ID
asc builds expire-all --app APP_ID --version 1.2.0

​
Common workflows

​
Upload and distribute to TestFlight

# Upload build
asc builds upload --app 123456789 --file MyApp.ipa

# Wait for processing
asc builds wait --app 123456789

# Distribute to beta group
asc builds add-groups --build BUILD_ID --group "External Testers"

​
Find latest build for a version

asc builds latest --app 123456789 --version 1.2.0

​
Upload flags

​
--app
string
required
App ID for the build
​
--file
string
required
Path to IPA file to upload
​
--platform
string
Platform: IOS, MAC_OS, TV_OSDefault: auto-detected from IPA

​
List flags

​
--app
string
required
App ID to list builds for
​
--filter
string
Filter builds by criteriaExample: processingState==VALID
​
--sort
string
Sort order: uploadedDate, -uploadedDate, version
​
--limit
number
Maximum number of results
​
--paginate
boolean
Fetch all pages automatically

​
Processing states

Builds go through several processing states:
StateDescription
PROCESSINGBuild is being processed
FAILEDProcessing failed
INVALIDBuild is invalid
VALIDBuild is ready for TestFlight

TestFlight command

Manage TestFlight resources

TestFlight guide

Complete TestFlight distribution guide