Skip to main content
POST
Execute tests

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
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
Launch parameters · object

Key-value pairs passed to the app at launch.

deviceprovidersettings
Device provider settings · object

Provider-specific device configuration.

build
Build · object
testinputs
Test inputs · object

Per-test input overrides, keyed by test ID.

deviceconfigs
DeviceConfiguration · object[]

List of device configurations to run tests on.

metadata
Metadata · object

Arbitrary metadata to attach to the execution.

Response

200 - application/json

Successful response

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.