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

# Rename or move folder

> Rename a folder, move it under another folder, or both in one call. `parentId: null` moves it back to the top level; omitting `parentId` leaves it where it is. Moving a folder takes its subfolders and its tests with it. Both halves are applied together, so a refused move never leaves the rename it came with applied.



## OpenAPI

````yaml /openapi.json patch /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:
    patch:
      summary: Rename or move folder
      description: >-
        Rename a folder, move it under another folder, or both in one call.
        `parentId: null` moves it back to the top level; omitting `parentId`
        leaves it where it is. Moving a folder takes its subfolders and its
        tests with it. Both halves are applied together, so a refused move never
        leaves the rename it came with applied.
      operationId: update_test_folder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFolder'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema: {}
              example:
                message: Folder renamed and moved successfully
                folderId: p7Rw3nVa5LcQe1Zt9uHb
        '400':
          description: >-
            Neither `name` nor `parentId` was given, the name is empty or too
            long, or the move would put the folder inside its own subtree.
        '404':
          description: The folder, or the folder named as `parentId`, does not exist.
components:
  schemas:
    UpdateFolder:
      title: UpdateFolder
      description: Send `folderId` plus `name`, `parentId`, or both.
      required:
        - folderId
      type: object
      properties:
        folderId:
          title: Folder ID
          type: string
        name:
          title: Name
          type: string
          maxLength: 60
          description: The new display name. Omit it to leave the name as it is.
        parentId:
          title: Parent ID
          type: string
          nullable: true
          description: >-
            Move the folder under this one, or `null` to move it to the top
            level. Omit the field to leave it where it is. A folder cannot be
            moved inside itself or one of its own subfolders.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````