Sign in

Execute tests

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.

post/tests/execute

Request body

organisationidstring required

Your MobileBoost organisation ID.

buildidstring

Alternative build identifier.

platformstring

Target platform (e.g. ios, android).

testidsstring[]

IDs of existing test cases to execute.

tagsstring[]

Execute all tests matching these tags.

tagsquerystring

A query expression to match tests by tags.

iterationsinteger

Number of times to repeat the test execution.

launchparamsobject

Key-value pairs passed to the app at launch.

deviceprovidersettingsobject

Provider-specific device configuration.

testinputsobject

Per-test input overrides, keyed by test ID.

metadataobject

Arbitrary metadata to attach to the execution.

Response

Successful response

messagestring required

A human-readable message describing the result of the request.

test_suite_idsstring[] required

The IDs of the test suite runs that were created. Use these with GET /suite/{suite_id}/status to poll for results.

statusstring required

The initial status of the created test suite runs.

Changes