Skip to main content

​
Overview

App management commands allow you to list, create, retrieve, and update apps in App Store Connect.

​
Commands

​
asc apps list

List apps from App Store Connect.
​
--bundle-id
string
Filter by bundle ID(s), comma-separated
​
--name
string
Filter by app name(s), comma-separated
​
--sku
string
Filter by SKU(s), comma-separated
​
--sort
string
Sort by: name, -name, bundleId, -bundleId
​
--limit
integer
Maximum results per page (1-200)
​
--next
string
Fetch next page using a links.next URL
​
--paginate
boolean
default:"false"
Automatically fetch all pages (aggregate results)
​
--output
string
default:"json"
Output format: json, table, markdown
Examples: 
asc apps list
asc apps list --bundle-id "com.example.app"
asc apps list --name "My App"
asc apps list --limit 10
asc apps list --sort name
asc apps list --output table
asc apps list --paginate
Response: 
{
  "data": [
    {
      "id": "123456789",
      "type": "apps",
      "attributes": {
        "name": "My App",
        "bundleId": "com.example.app",
        "sku": "MYAPP123",
        "primaryLocale": "en-US"
      }
    }
  ],
  "links": {
    "self": "https://api.appstoreconnect.apple.com/v1/apps?limit=10"
  }
}

​
asc apps get

Get app details by ID.
​
--id
string
required
App Store Connect app ID
​
--output
string
default:"json"
Output format: json, table
Examples: 
asc apps get --id "APP_ID"
asc apps get --id "APP_ID" --output table
Response: 
{
  "data": {
    "id": "APP_ID",
    "type": "apps",
    "attributes": {
      "name": "My App",
      "bundleId": "com.example.app",
      "sku": "MYAPP123",
      "primaryLocale": "en-US",
      "contentRightsDeclaration": "DOES_NOT_USE_THIRD_PARTY_CONTENT"
    }
  }
}

​
asc apps create

Create a new app in App Store Connect.
App creation requires Apple ID authentication (not API key). If 2FA is enabled, you may need to complete authentication in a browser first.
​
--name
string
required
App name
​
--bundle-id
string
required
Bundle ID (e.g., com.example.app)
​
--sku
string
required
Unique SKU for the app
​
--primary-locale
string
default:"en-US"
Primary locale (e.g., en-US, en-GB, de-DE)
​
--platform
string
default:"IOS"
Platform: IOS, MAC_OS, UNIVERSAL
​
--apple-id
string
Apple ID (email) for authentication
​
--password
string
Apple ID password (will prompt if not provided)
​
--two-factor-code
string
2FA verification code (if prompted)
​
--auto-rename
boolean
default:"true"
Auto-retry with a unique app name when the chosen name is already in use
Examples: 
asc apps create
asc apps create --name "My App" --bundle-id "com.example.myapp" --sku "MYAPP123"
asc apps create --name "My App" --bundle-id "com.example.myapp" --sku "MYAPP123" --primary-locale "en-GB" --platform IOS
asc apps create --apple-id "user@example.com" --password
Response: 
{
  "data": {
    "id": "NEW_APP_ID",
    "type": "apps",
    "attributes": {
      "name": "My App",
      "bundleId": "com.example.myapp",
      "sku": "MYAPP123",
      "primaryLocale": "en-US"
    }
  }
}

​
asc apps update

Update an app’s bundle ID, primary locale, or content rights declaration.
​
--id
string
required
App Store Connect app ID
​
--bundle-id
string
Update bundle ID
​
--primary-locale
string
Update primary locale (e.g., en-US)
​
--content-rights
string
Content rights declaration: DOES_NOT_USE_THIRD_PARTY_CONTENT or USES_THIRD_PARTY_CONTENT
Examples: 
asc apps update --id "APP_ID" --bundle-id "com.example.app"
asc apps update --id "APP_ID" --primary-locale "en-US"
asc apps update --id "APP_ID" --content-rights "DOES_NOT_USE_THIRD_PARTY_CONTENT"
Response: 
{
  "data": {
    "id": "APP_ID",
    "type": "apps",
    "attributes": {
      "bundleId": "com.example.app",
      "primaryLocale": "en-US",
      "contentRightsDeclaration": "DOES_NOT_USE_THIRD_PARTY_CONTENT"
    }
  }
}

​
asc apps wall

Display a visual wall of app icons and metadata. Examples: 
asc apps wall

​
Common Usage Patterns

​
List all apps and filter by bundle ID

asc apps list --bundle-id "com.example.app" --output table

​
Create an app with minimal flags

asc apps create --name "My App" --bundle-id "com.example.myapp" --sku "MYAPP123"

​
Get app details

asc apps get --id "123456789" --output json

​
Update app metadata

asc apps update --id "123456789" --primary-locale "en-GB"

​
Environment Variables

  • ASC_APP_ID - Default app ID for commands that require --app