---
title: "POST /v1/folders/move"
method: POST
path: "/v1/folders/move"
tags: ["folder"]
---

# POST /v1/folders/move

`POST /v1/folders/move`

Moves an item to another folder. You must specify the folder ID of the destination folder, as well as the ID of the item you want to move.

NOTE: In some situations, a single item can exist in multiple folders. If you attempt to move an item that exists in multiple folders, the API returns an `item_in_multiple_folders` error. In this case, you must use the Canva UI to move the item to another folder.

## Request body

- MoveFolderItemRequest — Body parameters for moving the folder.
  - `to_folder_id` string, required — The ID of the folder you want to move the item to (the destination folder). If you want to move the item to the top level of a Canva user's [projects](https://www.canva.com/help/find-designs-and-folders/), use the ID `root`.
  - `item_id` string, required — The ID of the item you want to move. Currently, video assets are not supported.

## Response `204`

OK

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Error Response

---

[API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/versions/499c392c7720/schema)