---
title: "Move folder to another parent folder or as a root folder"
method: POST
path: "/directory/v1/folders/move"
tags: ["Directory (Sites)"]
---

# Move folder to another parent folder or as a root folder

`POST /directory/v1/folders/move`

## Request body

- S12DirectoryV1MoveFoldersRequest — The parameters for `MoveFoldersRequest`
  - `ids` string[], required — Required. An array of folder IDs to move under the new parent.
  - `parent_id` string — Optional. New parent folder ID. If unspecified, the folder will be moved as a root folder
  - `domain` string — domain represents the type/domain/hierarchy for the folder. This is used for deleting folders within a specified domain. Defaults to site

## Response `200`

A successful response.

- S12DirectoryV1MoveFoldersResponse — Result returned from `MoveFoldersResponse`
  - `new_parent_id` string — New parent folder ID. Empty means the folder has been moved as root.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)