Uploads

Get upload status

Returns the current processing status of an upload. Poll this endpoint after calling POST /api/uploads/{uploadId}/submit until status is succeeded or failed.

get/api/uploads/{uploadId}

Request

Path parameters

uploadIdstring uuid required

UUID returned by POST /api/uploads.

Response

Upload details.

idstring uuid required
uploadArnstring nullable

Encrypted upload identifier token. Available once status is succeeded. Pass this value as uploadArn when creating sessions.

fileNamestring required
fileSizeinteger nullable

File size in bytes.

fileType'ANDROID_APP' | 'IOS_APP' required
appNamestring nullable

Human-readable app name (auto-extracted from APK/IPA).

appVersionstring nullable
identifierstring nullable

Bundle ID (iOS) or package name (Android).

iconDatastring nullable

Base64-encoded PNG app icon.

status'initialized' | 'processing' | 'succeeded' | 'failed' required
  • initialized — record created, waiting for file upload and submission.
  • processing — worker is uploading to Device Farm.
  • succeeded — ready to use in sessions.
  • failed — processing failed (see message for details).
messagestring nullable

Status details (e.g. error message on failure). Returned by GET /api/uploads/{uploadId} only; the list omits it.

uploadedAtstring date-time required
isExpiredboolean required

Whether the upload has expired on Device Farm (auto-expires after 30 days).

isUnavailableboolean

True when the upload cannot be used for a run (not succeeded, or expired). Returned by GET /api/uploads only.

Changes

No recorded changes to this operation across all 1 revision of this API.