Skip to main content

​
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.
​
--app
string
required
App Store Connect app ID (or ASC_APP_ID env variable)
​
--version
string
Filter by version string (comma-separated)
​
--platform
string
Filter by platform: IOS, MAC_OS, TV_OS, VISION_OS (comma-separated)
​
--state
string
Filter by state: PREPARE_FOR_SUBMISSION, WAITING_FOR_REVIEW, IN_REVIEW, PENDING_DEVELOPER_RELEASE, READY_FOR_SALE (comma-separated)
​
--limit
integer
Maximum results per page (1-200)
​
--next
string
Next page URL from a previous response
​
--paginate
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.
​
--version-id
string
required
App Store version ID
​
--include-build
boolean
default:"false"
Include attached build information
​
--include-submission
boolean
default:"false"
Include submission information
​
--include
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.
​
--app
string
required
App Store Connect app ID (or ASC_APP_ID env variable)
​
--version
string
required
Version string (e.g., 1.0.0)
​
--platform
string
default:"IOS"
Platform: IOS, MAC_OS, TV_OS, VISION_OS
​
--copyright
string
Copyright text (e.g., ‘2026 My Company’)
​
--release-type
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.
​
--version-id
string
required
App Store version ID
​
--copyright
string
Copyright text (e.g., ‘2026 My Company’)
​
--release-type
string
Release type: MANUAL, AFTER_APPROVAL, SCHEDULED
​
--earliest-release-date
string
Earliest release date (ISO 8601, e.g., 2026-02-01T08:00:00+00:00)
​
--version
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).
​
--version-id
string
required
App Store version ID
​
--confirm
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.
​
--version-id
string
required
App Store version ID
​
--build
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.
​
--version-id
string
required
App Store version ID
​
--confirm
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