Generate App Store screenshots in GitHub Actions.

Example request

name: Store screenshots
on:
  workflow_dispatch:
  push:
    tags: ["v*"]

jobs:
  screenshots:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Render screenshots
        run: |
          curl -X POST https://api.appscreenshotapi.com/v1/renders \
            -H "Authorization: Bearer $APPSCREENSHOTAPI_KEY" \
            -H "Content-Type: application/json" \
            -H "Idempotency-Key: $GITHUB_SHA-store-screenshots" \
            --data @store-screenshots.json
        env:
          APPSCREENSHOTAPI_KEY: ${{ secrets.APPSCREENSHOTAPI_KEY }}

Implementation checklist

• Store APPSCREENSHOTAPI_KEY in GitHub Actions secrets.
• Use a stable Idempotency-Key based on the commit or release tag.
• Upload returned images or archives as workflow artifacts.
• Stop for human approval when the API returns a billing_url.

CI-safe defaults

Store the API key in GitHub secrets, use a stable Idempotency-Key, and fail the workflow when lint findings return fail.

If the API returns 402, show the billing URL to a human instead of attempting autonomous payment.