> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asccli.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Apps

# Apps

> List and manage apps in App Store Connect

## Overview

The `apps` command is the main app-management surface for App Store Connect.

App creation no longer lives under `asc apps` in 1.0. Use `asc web apps create`
for the unofficial web-session creation flow, and see the
[Migrate to 1.0](/migrate-to-1-0) guide if you are updating older scripts.

## Commands

### `asc apps list`

List apps from App Store Connect.

<ParamField path="--bundle-id" type="string">
  Filter by bundle ID(s), comma-separated
</ParamField>

<ParamField path="--name" type="string">
  Filter by app name(s), comma-separated
</ParamField>

<ParamField path="--sku" type="string">
  Filter by SKU(s), comma-separated
</ParamField>

<ParamField path="--sort" type="string">
  Sort by: `name`, `-name`, `bundleId`, `-bundleId`
</ParamField>

<ParamField path="--limit" type="integer">
  Maximum results per page (1-200)
</ParamField>

<ParamField path="--next" type="string">
  Fetch next page using a links.next URL
</ParamField>

<ParamField path="--paginate" type="boolean" default="false">
  Automatically fetch all pages (aggregate results)
</ParamField>

<ParamField path="--output" type="string" default="json">
  Output format: `json`, `table`, `markdown`
</ParamField>

**Examples:**

```bash theme={null} theme={null}
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:**

```json theme={null} theme={null}
{
  "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 view`

View app details by ID.

<ParamField path="--id" type="string" required>
  App Store Connect app ID
</ParamField>

<ParamField path="--output" type="string" default="json">
  Output format: `json`, `table`
</ParamField>

**Examples:**

```bash theme={null} theme={null}
asc apps view --id "APP_ID"
asc apps view --id "APP_ID" --output table
```

**Response:**

```json theme={null} theme={null}
{
  "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 update`

Update an app's bundle ID, primary locale, or content rights declaration.

<ParamField path="--id" type="string" required>
  App Store Connect app ID
</ParamField>

<ParamField path="--bundle-id" type="string">
  Update bundle ID
</ParamField>

<ParamField path="--primary-locale" type="string">
  Update primary locale (e.g., en-US)
</ParamField>

<ParamField path="--content-rights" type="string">
  Content rights declaration: `DOES_NOT_USE_THIRD_PARTY_CONTENT` or `USES_THIRD_PARTY_CONTENT`
</ParamField>

**Examples:**

```bash theme={null} theme={null}
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:**

```json theme={null} theme={null}
{
  "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:**

```bash theme={null} theme={null}
asc apps wall
```

***

## Other App Surfaces

The `apps` family also includes several app-scoped surfaces that are not fully
expanded on this page yet:

* `asc apps wall` - Show or contribute to the community Wall of Apps
* `asc apps public` - Inspect public App Store storefront data
* `asc apps ci-product` - View the CI product for an app
* `asc apps remove-beta-testers` - Remove beta testers from an app
* `asc apps subscription-grace-period` - Inspect an app's subscription grace period
* `asc apps search-keywords` - Manage raw search-keyword relationships
* `asc apps app-encryption-declarations` - List app encryption declarations
* `asc apps content-rights` - Manage content-rights declarations

Use `asc apps --help` and `asc apps <subcommand> --help` to inspect the current
surface before scripting against a specific app workflow.

## Common Usage Patterns

### List all apps and filter by bundle ID

```bash theme={null} theme={null}
asc apps list --bundle-id "com.example.app" --output table
```

### Create an app with the web flow

```bash theme={null} theme={null}
asc web apps create --name "My App" --bundle-id "com.example.myapp" --sku "MYAPP123" --apple-id "user@example.com"
```

### View app details

```bash theme={null} theme={null}
asc apps view --id "123456789" --output json
```

### Update app metadata

```bash theme={null} theme={null}
asc apps update --id "123456789" --primary-locale "en-GB"
```

## Environment Variables

* `ASC_APP_ID` - Default app ID for commands that require `--app`