---
title: "Move a file or folder"
method: POST
path: "/documents/v1/move/{item_id}"
tags: ["Documents"]
---

# Move a file or folder

`POST /documents/v1/move/{item_id}`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/documents/v1/move/{item_id}`
- Auth: HTTP bearer

Move a file or folder to a different folder in Documents.

## Path parameters

- `item_id` string, required

## Request body

- S12DocumentsV1DocumentsPublicServiceMoveItemBody: Request to move an item (file or folder) to a different folder.
  - `target_folder_id` string: The ID of the folder where the item (file or folder) should be moved. If you don’t provide a target_folder_id, the item will be moved to the root folder. To get the `target_folder_id`, open the target folder in the SafetyCulture web app and copy the last part of the URL. For example, in this link `https://app.safetyculture.com/documents/9dd76834-65ef-41d3-815c-964df32450e4`, the target folder ID is `9dd76834-65ef-41d3-815c-964df32450e4`.

## Response `200`

A successful response.

- S12DocumentsV1MoveItemResponse

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
