---
title: "Execute tests"
method: POST
path: "/tests/execute"
---

# Execute tests

`POST /tests/execute`

Execute one or more tests on a device. Provide the test as inline commands (JSON or markdown format per the input requirements), or reference existing test IDs. Supports device configuration, launch parameters, and iteration control.

## Request body

- ExecuteTest
  - `organisationid` string, required — Your MobileBoost organisation ID.
  - `buildid` string — Alternative build identifier.
  - `platform` string — Target platform (e.g. `ios`, `android`).
  - `testids` string[] — IDs of existing test cases to execute.
  - `tags` string[] — Execute all tests matching these tags.
  - `tagsquery` string — A query expression to match tests by tags.
  - `iterations` integer — Number of times to repeat the test execution.
  - `launchparams` object — Key-value pairs passed to the app at launch.
  - `deviceprovidersettings` object — Provider-specific device configuration.
  - `build` Build
    - `meta` BuildMeta, required
      - `name` string, required
  - `testinputs` object — Per-test input overrides, keyed by test ID.
  - `deviceconfigs` DeviceConfiguration[] — List of device configurations to run tests on.
    - `locale` string
    - `organizationid` string
    - `osversion` string
    - `platform` string
    - `device` string
    - `orientation` string
    - `coordinates` object
  - `metadata` object — Arbitrary metadata to attach to the execution.

## Response `200`

Successful response

- object
  - `message` string, required — A human-readable message describing the result of the request.
  - `test_suite_ids` string[], required — The IDs of the test suite runs that were created. Use these with `GET /suite/{suite_id}/status` to poll for results.
  - `status` string, required — The initial status of the created test suite runs.

---

[API](https://skmtc.dev/mobileboost/apis/mobileboost-api.md) · [All operations](https://skmtc.dev/mobileboost/apis/mobileboost-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mobileboost/mobileboost-api/revisions/005e59399710/schema)