---
title: "Move a folder"
method: POST
path: "/folders/{folder_id}/move"
tags: ["Folders"]
---

# Move a folder

`POST /folders/{folder_id}/move`

Moves a folder to a new parent folder or to the root level. All templates and subfolders
within the folder are moved together. Cannot move a folder into one of its own subfolders.

## Path parameters

- `folder_id` string, required

## Request body

- object
  - `parent_folder_id` string, nullable

## Response `200`

move to root folder

- Folder
  - `id` string, nullable, required
  - `name` string, nullable, required
  - `path` string, nullable, required
  - `parent_folder_id` string, nullable, required

## Other responses

- `401` — authentication failed
- `404` — parent folder doesn't exist

---

[API](https://skmtc.dev/docspring/apis/docspring-api.md) · [All operations](https://skmtc.dev/docspring/apis/docspring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docspring/docspring-api/revisions/5726657b9432/schema)