Ship on the App Store #04 — The ASC API Submission Playbook

Apple gives you API endpoints. This playbook gives you the order to call them, the states that accept them, and what to do when everything answers 409 Conflict.

Reverse-engineered from 40+ production review submissions across 17+ apps — including every race condition Apple never documents. If you automate submissions or just want to stop clicking through six screens per release, this is the manual.

What you get:

The exact 3-call submission sequence (create Review Submission → attach items → attach build), copy-paste ready.

The Review Submission state machine explained: PREPARE → IN_REVIEW, per-item gates, and why your submit silently no-ops.

The 409 war table: every conflict cataloged with its real cause and fix — build sync races, locked item attachments, frozen appInfo, screenshot pools.

The live-version asset freeze: why deleting screenshots returns 409 on both API and web, and the new-version-container workaround.

Metadata-only submission truth: you still need a real build with a bumped version number.

Submission hygiene rules: one variable per release, single-shot submissions, and the rate budget that keeps you out of 4.3 territory.

Format: 5-page PDF, instant download, free lifetime updates.

FAQ

Does this work with the latest API version? Yes — includes the new Review Submissions flow current as of Oct 2026.

Do I need to be a developer? Some coding comfort helps, but every request is copy-paste ready with curl-style structure.