5. Upload App File – Send APK/IPA to DevicePark Storage

Before starting automated tests, you need to upload the mobile application you want to test. This step involves sending your .apk (for Android) or .ipa (for iOS) file to the DevicePark Storage API.

After uploading, you'll receive a fileKey, which is used to reference the uploaded app in your test configuration (e.g., Appium Desired Capabilities).

Purpose

This API allows you to:

  • Upload your mobile application (.apk or .ipa) to DevicePark

  • Get a unique fileKey that will be used in automation test setup

  • Store test app files centrally for reuse in other sessions

Endpoint

POST https://devicepark.testinium.io/storage/api/storage/files/stream

Required Headers

Header
Value
Required
Description

Authorization

Bearer <ACCESS_TOKEN>

Token obtained in Step 1

Content-Type

application/octet-stream

Required for binary file upload

file-name

<file_name>.apk or .ipa

The name of the file you are uploading

Request Body

The binary data of your mobile application file.

Example cURL Command

curl --location 'https://devicepark.testinium.io/storage/api/storage/files/stream' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/octet-stream' \
--header 'file-name: myApp-debug.apk' \
--data-binary '@./myApp-debug.apk'

Replace myApp-debug.apk with the actual name of your file and ensure that the @ symbol is followed by the correct file path on your local machine.

Example Successful Response

{
  "fileKey": "29a208ef-2301-4a18-9fad-6349bf7d8701"
}
  • fileKey: This is the unique identifier of the uploaded application. You will use this value when configuring your test session in Step 7.

Notes

  • You can upload the same application once and reuse the fileKey in multiple sessions.

  • The uploaded file is stored securely and will only be accessible via your organization's authenticated sessions.

  • The fileKey must be used exactly as returned (do not modify or alter it).

When to Upload

  • You must upload your .apk or .ipa file before starting your Appium session.

  • If you already uploaded the file and have a valid fileKey, you can skip this step.

Last updated