I spent yesterday automating app submissions for 4 iOS apps. Straightforward task: hit an endpoint, POST the app version to App Review, done.

Except the endpoint I was reaching for — /appStoreVersionSubmissions — is deprecated.

Apple's replaced it with a three-step choreography using /reviewSubmissions . No official migration guide. Just a quiet documentation update and broken automation scripts all over GitHub.

Here's the flow, with working curl examples.

The old way (dead)

curl -X POST https://api.appstoreconnect.apple.com/v1/appStoreVersionSubmissions \ -H "Authorization: Bearer $JWT " \ -H "Content-Type: application/json" \ -d '{"data":{"type":"appStoreVersionSubmissions","relationships":{"appStoreVersion":{"data":{"id":"<versionId>","type":"appStoreVersions"}}}}}'

Enter fullscreen mode

Exit fullscreen mode

This worked. One endpoint, one request, done.…