What it does
Move or rename a file or directory. Both source and destination paths are tracked in version history, preserving the full audit trail. Set recursive: true to move all files under a directory path to a new location.Required scope
files:write
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
from_path | string | Yes | Current file or directory path (e.g., ‘drafts/proposal.md’ or ‘drafts/v1’) |
to_path | string | Yes | New file or directory path (e.g., ‘final/proposal.md’ or ‘final/v1’) |
recursive | boolean | No | If true, moves all files under from_path to to_path, preserving relative structure. Each file gets its own move version record. Default: false (single file move). |