API: Moving files or folders
| Target URL | /api.php/Drive/files/move |
| Required scope | modify |
| HTTP Method | POST |
| Output format | JSON |
Request Parameters Reference
| Parameter | Type | Required | Description |
|---|---|---|---|
| path | string | Yes | The FileRun path of the file/folder. See this page |
| moveTo | string | Yes | The FileRun path of the destination folder. See this page |
| overwrite | boolean (1/0) | No | Set to 1 to replace an existing file of the same name at the destination (since 2026.3.1). |
Without overwrite, a move onto a name which is already taken at the destination is refused.
With overwrite set to 1, a move onto an existing file replaces it. The replaced content is kept as a previous version of the file, or moved to the trash when file versioning is turned off. The moved file keeps its own metadata, shares and web links. Replacing requires that the account is allowed to delete the existing file. A move onto an existing folder is refused either way.