---
title: "Move folders to a new destination folder/team/user."
method: PATCH
path: "/folders/move"
---

# Move folders to a new destination folder/team/user.

`PATCH /folders/move`

Requires scope `folder:write`.

## Request body

- object
  - `destination` object
    - `folderId` number, required — ID of the folder that the folders should be copied into. The authenticated user must have access to this folder. Null is the root folder of user or team.
    - `teamId` string — ID of the team that owns the desination folder and will own the copied folders and charts. If folderId is provided the team owning this folder must match with this ID. The authenticated user must have access to this team. Null is the user's private archive.
    - `workspace` string — Slug of the workspace that the destination of the folder belongs to. The authenticated user must have access to this workspace.
  - `folders` number[], required — IDs of folders that should be moved to the new destination. Must be accessible by the authenticated user. Not more than 1000 are allowed per request.

## Response `default`

Successful

---

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