asc-id-resolver

SKILL.md

---
name: asc-id-resolver
description: Resolve App Store Connect IDs (apps, builds, app and digital-goods versions, groups, testers) from human-friendly names using asc. Use when commands require IDs.
---

# asc id resolver

Use this skill to map names to IDs needed by other commands.

## App ID
- By bundle ID or name:
  - `asc apps list --bundle-id "com.example.app"`
  - `asc apps list --name "My App"`
- Fetch everything:
  - `asc apps list --paginate`
- Set default:
  - `ASC_APP_ID=...`

## Build ID
- Latest build:
  - `asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS`
- Recent builds:
  - `asc builds list --app "APP_ID" --sort -uploadedDate --limit 5`

## Version ID
- `asc versions list --app "APP_ID" --paginate`

## Digital-goods version IDs

API 4.4.1 version IDs are distinct from IAP product, subscription, and
subscription-group IDs:

Resolve the owning resources first:

- IAPs: `asc iap list --app "APP_ID" --paginate --output json`
- Subscription groups: `asc subscriptions groups list --app "APP_ID" --paginate --output json`
- Subscriptions: `asc subscriptions list --app "APP_ID" --paginate --output json`
  or `asc subscriptions list --group-id "GROUP_ID" --paginate --output json`

Then resolve their version IDs:

- IAP versions: `asc iap versions list --iap-id "IAP_ID" --paginate --output json`
- Subscription versions: `asc subscriptions versions list --subscription-id "SUB_ID" --paginate --output json`
- Subscription group versions: `asc subscriptions groups versions list --group-id "GROUP_ID" --paginate --output json`

Resolve child localization or image IDs from the corresponding version subtree:

- IAP localizations: `asc iap versions localizations list --version-id "VERSION_ID" --paginate --output json`
- IAP primary image: `asc iap versions image --version-id "VERSION_ID" --output json`
- IAP image collection: `asc iap versions images list --version-id "VERSION_ID" --paginate --output json`
- Subscription localizations: `asc subscriptions versions localizations list --version-id "VERSION_ID" --paginate --output json`
- Subscription primary image: `asc subscriptions versions images primary --version-id "VERSION_ID" --output json`
- Subscription image collection: `asc subscriptions versions images list --version-id "VERSION_ID" --paginate --output json`
- Subscription-group localizations: `asc subscriptions groups versions localizations list --version-id "VERSION_ID" --paginate --output json`

## TestFlight IDs
- Groups:
  - `asc testflight groups list --app "APP_ID" --paginate`
- Testers:
  - `asc testflight testers list --app "APP_ID" --paginate`

## Pre-release version IDs
- `asc testflight pre-release list --app "APP_ID" --platform IOS --paginate`

## Review submission IDs
- `asc review submissions list --app "APP_ID" --paginate`

## Output tips
- Output defaults are TTY-aware: table in a terminal and minified JSON in pipes
  or CI. An explicit `--output` wins.
- Use explicit `--output json` for automation and add `--pretty` only for
  human-readable JSON.
- For human viewing, use `--output table` or `--output markdown`.

## Guardrails
- Prefer `--paginate` on list commands to avoid missing IDs.
- Use `--sort` where available to make results deterministic.