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

# Create test

> Create a new test case with natural-language commands.



## OpenAPI

````yaml /openapi.json post /tests
openapi: 3.0.2
info:
  title: MobileBoost API
  version: 1.0.0
servers:
  - url: https://api.mobileboost.io
security:
  - BearerAuth: []
paths:
  /tests:
    post:
      summary: Create test
      description: Create a new test case with natural-language commands.
      operationId: create_test
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Create'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  testId:
                    type: string
                    description: The unique identifier of the created test
              example:
                testId: xMIt964RUpAB95b6YI2F
components:
  schemas:
    Create:
      title: Create
      required:
        - commands
      type: object
      properties:
        commands:
          title: Commands
          type: array
          items:
            type: string
          description: Natural-language commands that make up the test case.
        title:
          title: Title
          type: string
          default: ''
          description: Human-readable title of the test.
        tags:
          title: Tags
          type: array
          items:
            type: string
          description: Tags used to group or filter tests.
        preRequests:
          title: Pre-requests
          type: array
          items:
            $ref: '#/components/schemas/PreRequest'
          description: >-
            HTTP requests executed before the test runs (e.g. to seed state or
            fetch tokens).
        launchParams:
          title: Launch parameters
          type: array
          items:
            $ref: '#/components/schemas/LaunchParam'
          description: Key/value pairs passed to the test at launch.
        testInputs:
          title: Test inputs
          type: array
          items:
            $ref: '#/components/schemas/TestInput'
          description: Named inputs referenced by the test commands, with default values.
        teardownRequests:
          title: Teardown requests
          type: array
          items:
            $ref: '#/components/schemas/TearDownRequest'
          description: >-
            HTTP requests executed after the test finishes (e.g. to clean up
            state).
    PreRequest:
      title: PreRequest
      type: object
      properties:
        curlCommand:
          title: cURL command
          type: string
          default: ''
          description: The cURL command to execute before the test runs.
        delayBeforeRequest:
          title: Delay before request
          type: integer
          default: 0
          description: Delay in milliseconds to wait before issuing the request.
        valuesToRemember:
          title: Values to remember
          type: array
          items:
            type: string
          default: []
          description: >-
            JSON paths (or identifiers) of values from the response to remember
            for later use in the test.
    LaunchParam:
      title: LaunchParam
      required:
        - key
        - value
      type: object
      properties:
        key:
          title: Key
          type: string
          description: Launch parameter name.
        value:
          title: Value
          type: string
          description: Launch parameter value.
    TestInput:
      title: TestInput
      required:
        - key
        - defaultValue
      type: object
      properties:
        key:
          title: Key
          type: string
          description: Input identifier referenced by the test commands.
        defaultValue:
          title: Default value
          type: string
          description: Default value used when no override is supplied at execution time.
    TearDownRequest:
      title: TearDownRequest
      type: object
      properties:
        curlCommand:
          title: cURL command
          type: string
          default: ''
          description: The cURL command to execute after the test finishes.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````