Getting started

The MobileBoost API lets you manage tests, upload builds, trigger executions, and retrieve run results programmatically.

Base URL

All API requests use the following base URL:

https://api.mobileboost.io

Authentication

Authenticate every request by including a Bearer token in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.mobileboost.io/tests

Create an API key in the MobileBoost Platform under Settings > API keys. Keys start with mb_live_.

Quick example

Create a test, upload a build, run the test, and read the results:

Create a test

curl -X POST https://api.mobileboost.io/tests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Login flow",
    "commands": ["Tap Log in", "Enter credentials", "Verify home screen"]
  }'

Upload a build

curl -X POST https://api.mobileboost.io/uploadBuild/ \
  -H "Content-Type: multipart/form-data" \
  -F "build=@app.apk" \
  -F "organisation_key=org123" \
  -F "platform=android" \
  -F "metadata={}"

Execute tests

Creating a test starts writing its automation code. Wait until GET /tests shows the test as runnable on your platform (platforms.android.runnable is true), then start a run:

curl -X POST https://api.mobileboost.io/tests/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "organisationId": "org123",
    "buildId": "BUILD_ID_FROM_STEP_2",
    "tags": ["smoke"]
  }'

The response carries the ID of the run in runId:

{
  "message": "Autotest run created",
  "runId": "b1111111df174791a93e560390ea7e65",
  "status": "running"
}

Get the results

Pass runId to GET /runs/{runId}. Repeat the call until status is completed or cancelled:

curl https://api.mobileboost.io/runs/b1111111df174791a93e560390ea7e65 \
  -H "Authorization: Bearer YOUR_API_KEY"

Each test is listed in succeededTests, failedTests or blockedTests, with a link to its report. See Get run status for the full response.

Tests

Folders

Runs

Builds

Native Runners

Audit

Usage

Getting started

Base URL

Authentication

Quick example

​Base URL

​Authentication

​Quick example

Base URL

Authentication

Quick example