Version Management Commands

Manage App Store versions, builds, and releases

Overview

Version management commands allow you to create, update, delete, and manage App Store versions.

Commands

`asc versions list`

List app store versions for an app.

string

required

App Store Connect app ID (or ASC_APP_ID env variable)

string

Filter by version string (comma-separated)

string

Filter by platform: IOS, MAC_OS, TV_OS, VISION_OS (comma-separated)

string

Filter by state: PREPARE_FOR_SUBMISSION, WAITING_FOR_REVIEW, IN_REVIEW, PENDING_DEVELOPER_RELEASE, READY_FOR_SALE (comma-separated)

integer

Maximum results per page (1-200)

string

Next page URL from a previous response

boolean

default:"false"

Automatically fetch all pages (aggregate results)

Examples:

asc versions list --app "123456789"
asc versions list --app "123456789" --version "1.0.0"
asc versions list --app "123456789" --platform IOS --state READY_FOR_REVIEW
asc versions list --app "123456789" --paginate

Response:

{
  "data": [
    {
      "id": "VERSION_ID",
      "type": "appStoreVersions",
      "attributes": {
        "versionString": "1.0.0",
        "platform": "IOS",
        "appStoreState": "READY_FOR_SALE",
        "createdDate": "2024-01-15T10:30:00.000+0000"
      }
    }
  ]
}

`asc versions view`

View details for an app store version. In 1.0, the deprecated asc versions get alias was removed. Use asc versions view as the canonical command.

string

required

App Store version ID

boolean

default:"false"

Include attached build information

boolean

default:"false"

Include submission information

string

Include related resources (comma-separated): ageRatingDeclaration, appStoreReviewDetail, appClipDefaultExperience, appStoreVersionExperiments, appStoreVersionExperimentsV2, appStoreVersionSubmission, customerReviews, routingAppCoverage, alternativeDistributionPackage, gameCenterAppVersion

Examples:

asc versions view --version-id "VERSION_ID"
asc versions view --version-id "VERSION_ID" --include-build --include-submission
asc versions view --version-id "VERSION_ID" --include "ageRatingDeclaration,appStoreReviewDetail"

Response:

{
  "id": "VERSION_ID",
  "versionString": "1.0.0",
  "platform": "IOS",
  "state": "READY_FOR_SALE",
  "buildId": "BUILD_ID",
  "buildVersion": "100",
  "submissionId": "SUBMISSION_ID"
}

`asc versions create`

Create a new app store version.

string

required

App Store Connect app ID (or ASC_APP_ID env variable)

string

required

Version string (e.g., 1.0.0)

string

default:"IOS"

Platform: IOS, MAC_OS, TV_OS, VISION_OS

string

Release type: MANUAL, AFTER_APPROVAL, SCHEDULED

Examples:

asc versions create --app "123456789" --version "2.0.0"
asc versions create --app "123456789" --version "2.0.0" --platform IOS
asc versions create --app "123456789" --version "2.0.0" --copyright "2026 My Company" --release-type MANUAL

Response:

{
  "id": "NEW_VERSION_ID",
  "versionString": "2.0.0",
  "platform": "IOS",
  "state": "PREPARE_FOR_SUBMISSION"
}

`asc versions update`

Update an app store version.

string

required

App Store version ID

string

Release type: MANUAL, AFTER_APPROVAL, SCHEDULED

string

Earliest release date (ISO 8601, e.g., 2026-02-01T08:00:00+00:00)

string

Version string (e.g., 1.0.1)

Examples:

asc versions update --version-id "VERSION_ID" --copyright "2026 My Company"
asc versions update --version-id "VERSION_ID" --release-type MANUAL
asc versions update --version-id "VERSION_ID" --release-type SCHEDULED --earliest-release-date "2026-02-01T08:00:00+00:00"
asc versions update --version-id "VERSION_ID" --version "1.0.1"

Response:

{
  "id": "VERSION_ID",
  "versionString": "1.0.1",
  "platform": "IOS",
  "state": "PREPARE_FOR_SUBMISSION"
}

`asc versions delete`

Delete an app store version (only versions in PREPARE_FOR_SUBMISSION state).

string

required

App Store version ID

boolean

required

Confirm deletion (required)

Examples:

asc versions delete --version-id "VERSION_ID" --confirm

Response:

{
  "versionId": "VERSION_ID",
  "deleted": true
}

`asc versions attach-build`

Attach a build to an app store version.

string

required

App Store version ID

string

required

Build ID to attach

Examples:

asc versions attach-build --version-id "VERSION_ID" --build "BUILD_ID"

Response:

{
  "versionId": "VERSION_ID",
  "buildId": "BUILD_ID",
  "attached": true
}

`asc versions release`

Release an approved version in the Pending Developer Release state.

string

required

App Store version ID

boolean

required

Confirm release request (required)

Examples:

asc versions release --version-id "VERSION_ID" --confirm

Response:

{
  "releaseRequestId": "RELEASE_REQUEST_ID",
  "versionId": "VERSION_ID"
}

Common Usage Patterns

Create a new version and attach a build

asc versions create --app "123456789" --version "2.0.0" --platform IOS
asc versions attach-build --version-id "VERSION_ID" --build "BUILD_ID"

List versions in a specific state

asc versions list --app "123456789" --state WAITING_FOR_REVIEW,IN_REVIEW

Update version release type

asc versions update --version-id "VERSION_ID" --release-type SCHEDULED --earliest-release-date "2026-03-01T08:00:00+00:00"

Release a pending version

asc versions release --version-id "VERSION_ID" --confirm

Version States

PREPARE_FOR_SUBMISSION - Version is being prepared
WAITING_FOR_REVIEW - Version is waiting for Apple review
IN_REVIEW - Version is currently under review
PENDING_CONTRACT - Pending contract approval
WAITING_FOR_EXPORT_COMPLIANCE - Waiting for export compliance
PENDING_DEVELOPER_RELEASE - Approved and waiting for developer to release
PROCESSING_FOR_APP_STORE - Processing for release
PENDING_APPLE_RELEASE - Pending Apple release
READY_FOR_SALE - Live on the App Store
REMOVED_FROM_SALE - Removed from sale
DEVELOPER_REJECTED - Rejected by developer
REJECTED - Rejected by Apple
METADATA_REJECTED - Metadata rejected
INVALID_BINARY - Binary is invalid

Overview

App Management

TestFlight & Builds

Monetization & Analytics

Signing

Review & Release

Team & Access

Automation & Utilities

Versions

Version Management Commands

Overview

Commands

`asc versions list`

`asc versions view`

`asc versions create`

`asc versions update`

`asc versions delete`

`asc versions attach-build`

`asc versions release`

Common Usage Patterns

Create a new version and attach a build

List versions in a specific state

Update version release type

Release a pending version

Version States

​Version Management Commands

​Overview

​Commands

​asc versions list

​asc versions view

​asc versions create

​asc versions update

​asc versions delete

​asc versions attach-build

​asc versions release

​Common Usage Patterns

​Create a new version and attach a build

​List versions in a specific state

​Update version release type

​Release a pending version

​Version States

Version Management Commands

Overview

Commands

`asc versions list`

`asc versions view`

`asc versions create`

`asc versions update`

`asc versions delete`

`asc versions attach-build`

`asc versions release`

Common Usage Patterns

Create a new version and attach a build

List versions in a specific state

Update version release type

Release a pending version

Version States