What it does
Soft-delete a file or directory. The target disappears from list_files but all prior versions are preserved. Use restore_version to bring it back. Set recursive: true to delete all files under a directory path. Each file gets its own tombstone version for individual undo.Required scope
files:write
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | Yes | Path of the file or directory to delete (e.g., ‘temp/draft.txt’ or ‘old-project’) |
recursive | boolean | No | If true, deletes all files under the given directory path. Each file is individually tombstoned and restorable. Default: false (single file delete). |