---
title: "Copy folders to a new destination folder/team/user."
method: POST
path: "/folders/copy"
---

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

`POST /folders/copy`

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 destination 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 100 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)