Edit metadata, upload screenshots, configure purchases and prepare submissions. Pull sales, analytics and performance reports with the same CLI.
Get startedPut supported App Store configuration in YAML alongside your app. Fetch what’s live, edit locally, and review the diff before applying changes.
flightline fetch app.tideterm.ios > state.yamlflightline plan state.yamlflightline apply state.yaml --confirmExample bundle ID. YAML support varies by resource; direct commands cover additional operations.
Name, subtitle, description, keywords, release notes, URLs and categories.
Attach an uploaded build. Manage screenshots, ordering, preview videos and custom product page assets.
Reviewer demo info, age rating, export-compliance answers, content rights, custom EULA and accessibility drafts.
Run a command for a specific task. You don’t need a state file to use the CLI.
Manage beta testers, builds and feedback.
Invitation resend and recruitment-criteria writes are not supported.
Manage products, pricing and purchase assets.
Subscription products are read-only. Subscription reports are available.
Configure events and product page experiments.
Events and experiments use direct commands. Proposing an item does not submit it.
Handle customer feedback and inspect deliveries.
Replacing a review response requires a separate delete. A ping does not confirm delivery.
Read reports from your terminal. Pipe JSON into scripts, export raw report files, or keep snapshots in your own systems.
Read Sales and Trends reports for a day, week, month or year. Table and JSON output are filtered to your app. Raw TSV contains Apple’s vendor-wide report.
Reports and metrics guide ↗flightline sales app.tideterm.ios --days 30 --output json
Sales reports require your vendor number. The output lists dates with no available report.
Example app and identifiers.Applying configuration never submits your app. App Store Review starts with a separate, confirmed command.
Lint validates the state file offline. Preflight reads live state and checks for specific issues with metadata, builds, purchases and release readiness.
See the 15 rules ↗Inspect the version and proposed items, assemble a draft, rerun the checks, then submit. Manual release and phased rollout have their own commands.
Submission and release guide ↗Passing checks does not guarantee App Review approval. IAP-version attachment and phased transitions have not yet been verified against a live account.
Expand a category to compare direct commands, YAML support and checks. “Yes” applies to the named workflow, not every operation in the API family.
| Workflow | Read | Direct write | YAML | Rule / check |
|---|---|---|---|---|
| Apps | Yes | No | No | No |
| Versions | Yes | Yes | Yes | Yes |
| Builds (incl. attach) | Yes | Yes | Yes | Yes |
| Metadata + localizations | Yes | Yes | Yes | Yes |
| Screenshots and ordering | Yes | Yes | Yes | Yes |
| Preview videos (main / CPP) | Yes | Yes | Yes | YAML validation |
| App Review attachments | Yes | Yes | No | No |
| Categories | Yes | Yes | Yes | No |
| Custom product pages | Yes | Yes | Yes | No |
Asset upload and processing are separate. Screenshot and preview support varies by parent and workflow.
| Workflow | Read | Direct write | YAML | Rule / check |
|---|---|---|---|---|
| Content rights / custom EULA | Yes | Yes | Yes | YAML validation |
| Age rating | Yes | Yes | Yes | Yes |
| Export compliance | Yes | Yes | Yes | Yes |
| Reviewer demo info | Yes | Yes | Yes | No |
| App tags | Yes | Yes (visibility) | No | No |
| Accessibility declarations | Yes | Yes (draft, publish, delete) | Yes (draft answers) | YAML validation |
| Privacy nutrition labels | Portal only | No | No | No |
Supply your own legal and accessibility answers. Publishing accessibility answers requires a separate command. Export documents and approval steps are not fully managed.
| Workflow | Read | Direct write | YAML | Rule / check |
|---|---|---|---|---|
| IAPs (metadata, review screenshot) | Yes | Yes | Yes | Yes (3 rules) |
| IAP commerce (price, territories) | Yes | Yes | Yes | YAML validation |
| IAP promotional images / promoted purchases | Yes | Yes (separate commands) | No | No |
| IAP offer codes | Yes | Yes (issue codes) | No | No |
| App availability / preorders | Yes | Partial (active preorders) | Partial (existing preorder territories) | YAML validation |
| Pricing | Yes | Yes | Yes | No |
| Subscription groups | Yes | No | No | No |
Non-subscription authoring only. Existing price windows are preserved. Ordinary availability mutations and preorder creation remain unsupported or unverified against a live account.
| Workflow | Read | Direct write | YAML | Rule / check |
|---|---|---|---|---|
| TestFlight groups, testers, beta-review submit | Yes | Yes | Yes (partial) | Yes |
| TestFlight metadata and build membership | Yes | Yes | Yes | YAML validation |
| Beta auto-notify / notifications / recruitment | Yes | Notification policy and send commands | No | No |
| Beta feedback (crash + screenshot) | Yes | No | No | No |
Beta App Review is separate from production review. Invitation resend and recruitment-criteria writes are not supported.
| Workflow | Read | Direct write | YAML | Rule / check |
|---|---|---|---|---|
| Review submissions (App Store Review) | Yes | Yes (assemble and submit) | No | Fresh preflight |
| In-app events / product page experiments | Yes | Yes (selected workflows, item proposals) | No | No |
| Phased release | Yes | Yes (enable/pause/resume) | Yes (supported transitions) | YAML validation |
| Manual version release | Yes | Yes (release command) | No | No |
Assembly requires an app version. Subscription, Game Center, custom product page and background-asset submission items are excluded. Events and experiments use direct commands; proposals do not submit.
| Workflow | Read | Direct write | YAML | Rule / check |
|---|---|---|---|---|
| Webhooks / deliveries | Yes | Yes (confirmed actions) | No | No |
| Customer reviews / responses | Yes | Yes (confirmed responses) | No | No |
Writes require confirmation. Replacing a response requires deletion; a webhook ping does not establish delivery.
| Workflow | Read | Direct write | YAML | Rule / check |
|---|---|---|---|---|
| Diagnostic signatures | Yes | No | No | No |
| Performance metrics + overview | Yes | No | No | No |
| Sales reports | Yes | No | No | No |
| Finance reports | Yes | No | No | No |
| Subscription reports | Yes | No | No | No |
| Analytics reports | Yes | No | No | No |
Report data depends on Apple’s availability and your API key permissions. Analytics requests and downloads are separate steps.
For unsupported tasks and workflows that still need the portal, seecapabilities and limitations.
Open the complete command reference ↗One binary and your App Store Connect API key.