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

# Move folder

`POST /folders/{folderId}/move`

Moves a folder.

## Headers

- `Content-Type` string

## Request body

- ContainerDestinationForMove
  - `destinationId` number, required — The ID of the destination container.
  - `destinationType` 'folder' | 'home' | 'workspace', nullable, required — Type of destination container. The `"home"` enum is **Deprecated** since March 25, 2025, and will be removed.

## Response `200`

Result object containing a success message, result code, and metadata of the moved folder's new container.

- object
  - `message` 'SUCCESS' — Message that indicates the request was successful.
  - `resultCode` 0 — * '0' Success
  - `result` object
    - `id` number — Container ID.
    - `name` string — Container name.
    - `permalink` string — URL that represents a direct link to the container 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)