> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobileboost.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml /openapi.json post /tests/execute
openapi: 3.0.2
info:
  title: MobileBoost API
  version: 1.0.0
servers:
  - url: https://api.mobileboost.io
security:
  - BearerAuth: []
paths:
  /tests/execute:
    post:
      summary: Execute tests
      description: >-
        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.
      operationId: execute_tests
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExecuteTest'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: >-
                      A human-readable message describing the result of the
                      request.
                  test_suite_ids:
                    type: array
                    description: >-
                      The IDs of the test suite runs that were created. Use
                      these with `GET /suite/{suite_id}/status` to poll for
                      results.
                    items:
                      type: string
                  status:
                    type: string
                    description: The initial status of the created test suite runs.
                required:
                  - message
                  - test_suite_ids
                  - status
              example:
                message: Test suite runs created
                test_suite_ids:
                  - b1111111df174791a93e560390ea7e65
                status: running
components:
  schemas:
    ExecuteTest:
      title: ExecuteTest
      required:
        - organisationid
      type: object
      properties:
        organisationid:
          title: Organisation ID
          type: string
          description: Your MobileBoost organisation ID.
        buildid:
          title: Build ID
          type: string
          description: Alternative build identifier.
        platform:
          title: Platform
          type: string
          description: Target platform (e.g. `ios`, `android`).
        testids:
          title: Test IDs
          type: array
          items:
            type: string
          description: IDs of existing test cases to execute.
        tags:
          title: Tags
          type: array
          items:
            type: string
          description: Execute all tests matching these tags.
        tagsquery:
          title: Tags query
          type: string
          description: A query expression to match tests by tags.
        iterations:
          title: Iterations
          type: integer
          description: Number of times to repeat the test execution.
        launchparams:
          title: Launch parameters
          type: object
          additionalProperties:
            type: string
          description: Key-value pairs passed to the app at launch.
        deviceprovidersettings:
          title: Device provider settings
          type: object
          description: Provider-specific device configuration.
        build:
          $ref: '#/components/schemas/Build'
        testinputs:
          title: Test inputs
          type: object
          additionalProperties:
            type: object
            additionalProperties:
              type: string
          description: Per-test input overrides, keyed by test ID.
        deviceconfigs:
          title: Device configs
          type: array
          items:
            $ref: '#/components/schemas/DeviceConfiguration'
          default: []
          description: List of device configurations to run tests on.
        metadata:
          title: Metadata
          type: object
          default: {}
          description: Arbitrary metadata to attach to the execution.
    Build:
      title: Build
      required:
        - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/BuildMeta'
    DeviceConfiguration:
      title: DeviceConfiguration
      type: object
      properties:
        locale:
          title: Locale
          type: string
          default: ''
        organizationid:
          title: Organisation ID
          type: string
          default: ''
        osversion:
          title: OS version
          type: string
          default: ''
        platform:
          title: Platform
          type: string
          default: ''
        device:
          title: Device
          type: string
          default: ''
        orientation:
          title: Orientation
          type: string
          default: ''
        coordinates:
          title: Coordinates
          type: object
          default: {}
    BuildMeta:
      title: BuildMeta
      required:
        - name
      type: object
      properties:
        name:
          title: Name
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````