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

> Create a folder. Pass `parentId` to nest it inside another folder, or leave it out for a top-level one. Folder names are for people to read: two folders may share a name, and everything that refers to a folder uses its id.



## OpenAPI

````yaml /openapi.json post /tests/folders
openapi: 3.0.2
info:
  title: MobileBoost API
  version: 1.0.0
servers:
  - url: https://api.mobileboost.io
security:
  - BearerAuth: []
paths:
  /tests/folders:
    post:
      summary: Create folder
      description: >-
        Create a folder. Pass `parentId` to nest it inside another folder, or
        leave it out for a top-level one. Folder names are for people to read:
        two folders may share a name, and everything that refers to a folder
        uses its id.
      operationId: create_test_folder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFolder'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  folderId:
                    type: string
                    description: The unique identifier of the created folder.
                  folder:
                    $ref: '#/components/schemas/Folder'
              example:
                folderId: p7Rw3nVa5LcQe1Zt9uHb
                folder:
                  id: p7Rw3nVa5LcQe1Zt9uHb
                  name: Payments
                  parentId: kFq2b8s1TzYwm0Xd4eNc
                  path: Checkout / Payments
                  testCount: 0
        '400':
          description: >-
            The name is empty or longer than 60 characters, or this
            organisation's tests are QA Studio no-code tests.
        '404':
          description: The folder named as `parentId` does not exist.
components:
  schemas:
    CreateFolder:
      title: CreateFolder
      required:
        - name
      type: object
      properties:
        name:
          title: Name
          type: string
          maxLength: 60
          description: Display name, up to 60 characters.
        parentId:
          title: Parent ID
          type: string
          nullable: true
          description: >-
            Nest the new folder inside this one. Omit it, or send `null`, for a
            top-level folder.
    Folder:
      title: Folder
      type: object
      properties:
        id:
          title: Folder ID
          type: string
          description: The id everything else refers to this folder by.
        name:
          title: Name
          type: string
          description: Display name. Two folders may share one.
        parentId:
          title: Parent ID
          type: string
          nullable: true
          description: The folder this one sits in, or `null` at the top level.
        path:
          title: Path
          type: string
          description: The names from the top level down, joined with ` / `.
        testCount:
          title: Test count
          type: integer
          description: Tests in this folder, counting its subfolders.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````