Skip to main content

Upload Build File

Use this guide to upload an external Android build file using a Panto API key.

For shared connection details, see Overview.

Endpoint​

POST /api/v1/qa/external/app/upload

Content Type​

multipart/form-data

Request Fields​

  • app_name (string, required): Display name for the uploaded app.
  • apk_file (file, required): Android APK file to upload.

Successful Response​

{
  "id": "app_01",
  "name": "My Android App",
  "created_at": "2026-05-21T10:30:00Z",
  "updated_at": "2026-05-21T10:30:00Z"
}

Validation and Error Cases​

{
  "error": "Only .apk files are allowed"
}
{
  "error": "Invalid or expired API key"
}

cURL Example​

curl -X POST "https://qa-app.getpanto.ai/api/v1/qa/external/app/upload" \
  -H "X-PANTO-API-KEY: your_api_key_here" \
  -F "app_name=My Android App" \
  -F "apk_file=@./app-release.apk"

Integration Notes​

  • The upload flow also creates the build record and schedules blob upload in the background.
  • Use the returned id as the app_id when triggering test flows or test suites.