Batch Upload

Overview

Batch upload lets you upload 2–10 APK versions of the same game in a single workflow. The pipeline processes them in version order and generates version comparison data automatically.

Using the dashboard

1. Go to Upload → select the Batch tab
2. Drop 2–10 APK files (same game, different versions)
3. Verify the version order looks correct
4. Click Submit batch
5. Monitor progress on the Jobs page

Version ordering

APKs are sorted by versionCode extracted from AndroidManifest.xml. You don't need to name files in any specific order — the pipeline sorts automatically.

API workflow

1. Initialize batch

POST /api/saas/batch/init
Content-Type: application/json

{
  "package_name": "com.example.game",
  "count": 3
}

Returns {batch_id, items: [{item_id}]}.

2. Upload each APK

For each item in the batch:

POST /api/saas/batch/{batch_id}/item/{item_id}/upload/init
POST /api/saas/batch/{batch_id}/item/{item_id}/upload/part   ← repeat for each chunk
POST /api/saas/batch/{batch_id}/item/{item_id}/upload/complete

3. Submit for processing

POST /api/saas/batch/{batch_id}/submit

The pipeline sorts by versionCode and queues jobs in order.

AI batch (server-side)

If APKs are already hosted online, use the AI batch endpoint to skip the upload step:

POST /api/saas/batch/ai/from-urls
Content-Type: application/json

{
  "urls": [
    "https://example.com/game-1.0.0.apk",
    "https://example.com/game-1.0.8.apk"
  ]
}

The server downloads, extracts, and queues the jobs automatically.