Review Commands

Manage App Store review details, attachments, submissions, and history

The review command uses hyphenated leaf subcommands for app-scoped review status, blocker diagnosis, review details, attachments, submissions, and submission items.

Overview

Common review commands:

asc review status --app "123456789"
asc review doctor --app "123456789"
asc review details-get --id "DETAIL_ID"
asc review details-for-version --version-id "VERSION_ID"
asc review details-create --version-id "VERSION_ID" --contact-email "[email protected]"
asc review details-update --id "DETAIL_ID" --notes "Updated review notes"
asc review attachments-list --review-detail "DETAIL_ID"
asc review attachments-get --id "ATTACHMENT_ID"
asc review attachments-upload --review-detail "DETAIL_ID" --file ./review-doc.pdf
asc review submissions-list --app "123456789"
asc review submissions-get --id "SUBMISSION_ID"
asc review submissions-create --app "123456789" --platform IOS
asc review submissions-submit --id "SUBMISSION_ID" --confirm
asc review submissions-cancel --id "SUBMISSION_ID" --confirm
asc review submissions-update --id "SUBMISSION_ID" --canceled=true
asc review submissions-items-ids --id "SUBMISSION_ID"
asc review items-get --id "ITEM_ID"
asc review items-list --submission "SUBMISSION_ID"
asc review items-add --submission "SUBMISSION_ID" --item-type appStoreVersions --item-id "VERSION_ID"
asc review items-update --id "ITEM_ID" --state READY_FOR_REVIEW
asc review items-remove --id "ITEM_ID" --confirm
asc review history --app "123456789"

Commands

`asc review status`

Show app-scoped App Review status and the next recommended action. Examples:

asc review status --app "123456789"
asc review status --app "123456789" --version "1.2.3"
asc review status --app "123456789" --version-id "VERSION_ID"

`asc review doctor`

Explain why an app cannot be submitted for review. Examples:

asc review doctor --app "123456789"
asc review doctor --app "123456789" --version "1.2.3"
asc review doctor --app "123456789" --version-id "VERSION_ID"

`asc review submissions-list`

List review submissions for an app or globally.

string

App Store Connect app ID (or ASC_APP_ID)

string

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

string

Filter by submission state (comma-separated)

boolean

default:"false"

Automatically fetch all pages

Examples:

asc review submissions-list --app "123456789"
asc review submissions-list --app "123456789" --platform IOS --state READY_FOR_REVIEW
asc review submissions-list --app "123456789" --paginate

`asc review submissions-get`

Get a review submission by ID.

string

required

Review submission ID

Examples:

asc review submissions-get --id "SUBMISSION_ID"

`asc review submissions-cancel`

Cancel a review submission.

string

required

Review submission ID

boolean

required

Confirm cancellation

Examples:

asc review submissions-cancel --id "SUBMISSION_ID" --confirm

`asc review details-update`

Update App Store review details.

string

required

App Store review detail ID

string

Contact email

string

Contact phone

string

Reviewer instructions or context

boolean

Set true only when App Review needs demo credentials

string

Demo account name when demo credentials are required

string

Demo account password when demo credentials are required

Examples:

asc review details-update --id "DETAIL_ID" --notes "Reviewer can use the guest flow from the welcome screen."
asc review details-update --id "DETAIL_ID" --demo-account-required=true --demo-account-name "[email protected]" --demo-account-password "rotated-password" --notes "This account has full reviewer access."

`asc review attachments-upload`

Upload a review attachment.

string

required

App Store review detail ID

string

required

Path to the attachment file

Examples:

asc review attachments-upload --review-detail "REVIEW_DETAIL_ID" --file ./review-doc.pdf

`asc review history`

Show enriched review submission history for an app.

string

App Store Connect app ID (or ASC_APP_ID)

string

Filter by platform: IOS, MAC_OS, TV_OS, VISION_OS

string

Filter by submission state

string

Filter by version string (for example 1.2.0)

boolean

default:"false"

Automatically fetch all pages

Examples:

asc review history --app "123456789"
asc review history --app "123456789" --platform IOS --state COMPLETE
asc review history --app "123456789" --version "1.2.0"

Additional Current Subcommands

The live review surface also includes:

asc review attachments-get
asc review attachments-delete
asc review submissions-update
asc review submissions-items-ids
asc review items-list
asc review items-update
asc review items-remove

Use asc review --help for the full current subcommand list.

Submit command

Check submission status or submit builds for App Store review

Reviews command

Manage customer reviews

Submission guide

Complete submission guide

Overview

App Management

TestFlight & Builds

Monetization & Analytics

Signing

Review & Release

Team & Access

Automation & Utilities

Review

Review Commands

Overview

Commands

`asc review status`

`asc review doctor`

`asc review submissions-list`

`asc review submissions-get`

`asc review submissions-cancel`

`asc review details-update`

`asc review attachments-upload`

`asc review history`

Additional Current Subcommands

Submit command

Reviews command

Submission guide

​Review Commands

​Overview

​Commands

​asc review status

​asc review doctor

​asc review submissions-list

​asc review submissions-get

​asc review submissions-cancel

​asc review details-update

​asc review attachments-upload

​asc review history

​Additional Current Subcommands

​Related

Submit command

Reviews command

Submission guide

Review Commands

Overview

Commands

`asc review status`

`asc review doctor`

`asc review submissions-list`

`asc review submissions-get`

`asc review submissions-cancel`

`asc review details-update`

`asc review attachments-upload`

`asc review history`

Additional Current Subcommands

Related