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

# Move tests into a folder

> File several tests into a folder at once, or unfile them with `folderId: null`. Ids that no longer exist are skipped rather than failing the call, and a test already in that folder is left alone. To move a single test, `PATCH /tests` takes `folderId` too.



## OpenAPI

````yaml /openapi.json post /tests/folders/move
openapi: 3.0.2
info:
  title: MobileBoost API
  version: 1.0.0
servers:
  - url: https://api.mobileboost.io
security:
  - BearerAuth: []
paths:
  /tests/folders/move:
    post:
      summary: Move tests into a folder
      description: >-
        File several tests into a folder at once, or unfile them with `folderId:
        null`. Ids that no longer exist are skipped rather than failing the
        call, and a test already in that folder is left alone. To move a single
        test, `PATCH /tests` takes `folderId` too.
      operationId: move_tests_to_folder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MoveTests'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  movedTestIds:
                    type: array
                    description: Tests that changed folder.
                    items:
                      type: string
                  unchangedTestIds:
                    type: array
                    description: Tests that were already in that folder.
                    items:
                      type: string
                  skippedTestIds:
                    type: array
                    description: Ids that do not belong to any test in this organisation.
                    items:
                      type: string
              example:
                message: >-
                  Tests with following IDs were moved to 'kFq2b8s1TzYwm0Xd4eNc':
                  ['xMIt964RUpAB95b6YI2F'].
                movedTestIds:
                  - xMIt964RUpAB95b6YI2F
                unchangedTestIds: []
                skippedTestIds: []
        '404':
          description: >-
            The destination folder does not exist, or none of the ids match a
            test in this organisation.
components:
  schemas:
    MoveTests:
      title: MoveTests
      required:
        - testIds
      type: object
      properties:
        testIds:
          title: Test IDs
          type: array
          items:
            type: string
          description: >-
            The tests to file. Ids that no longer exist are skipped and reported
            back.
        folderId:
          title: Folder ID
          type: string
          nullable: true
          description: >-
            The destination folder, or `null` to take the tests out of their
            folders.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````