---
title: "Copy folder"
method: POST
path: "/folders/{folderId}/copy"
tags: ["folders"]
---

# Copy folder

`POST /folders/{folderId}/copy`

Copies a folder.

> **Important:** This operation doesn't copy cell history.

## Query parameters

- `include` 'attachments' | 'cellLinks' | 'data' | 'discussions' | 'filters' | 'forms' | 'ruleRecipients' | 'rules' | 'shares'
- `exclude` 'sheetHyperlinks'
- `skipRemap` 'cellLinks' | 'reports' | 'sheetHyperlinks' | 'sights'

## Headers

- `Content-Type` 'application/json', required

## Request body

- union
  - object — Copying a folder to another folder or workspace.
    - `newName` string, required — Name of the newly created folder.
    - `destinationType` 'folder' | 'workspace', required — Type of destination container.
    - `destinationId` integer, required — The ID of the destination folder or workspace.
  - object — Copying a folder to Home. Copying a folder to Home is **Deprecated** since March 25, 2025, and support will be removed.
    - `newName` string, required — Name of the newly created folder.
    - `destinationType` 'home', required — Type of destination container.

## Response `200`

Basic information about the new Folder

- object
  - `message` 'SUCCESS' — Message that indicates the request was successful.
  - `resultCode` 0 — * '0' Success
  - `result` FolderListing
    - `id` number — Folder ID.
    - `name` string — Folder name.
    - `permalink` string — URL that represents a direct link to the folder in Smartsheet.

## Other responses

- `default` — Generic Error Payload

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)