---
title: "Batch move files & folders"
method: POST
path: "/api/2/files/move"
tags: ["Secure spaces, folders & files"]
---

# Batch move files & folders

`POST /api/2/files/move`

## Request body

- object
  - `fileables` object[], required
    - `id` string, required — List of IDs of files (`file_###`) and folders (`folder_###`).
    - `conflict_behaviour` 'replace' | 'rename' | 'fail', nullable — Conflict behaviour to use if file or folder exists in destination. Defaults to fail if there's a file name conflict.
  - `folder` integer, nullable — The folder ID of the destination. Set to null (or omit) to move to the root.
  - `permissions_source` 'parent', nullable — Permission source.
  - `conflict_behaviour` 'replace' | 'rename' | 'fail', nullable — Default conflict behaviour for each file & folder. Defaults to fail if there's any file name conflict.

---

[API](https://skmtc.net/convoflo/apis/convoflo-rest-api.md) · [All operations](https://skmtc.net/convoflo/apis/convoflo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convoflo/convoflo-rest-api/revisions/fed4481f0476/schema)