delete_file
Soft-delete a file by id. Moves to a 30-day trash window before the cleanup cron hard-deletes + refunds the storage quota. Restorable via the REST PATCH endpoint (PATCH /api/workspaces/{slug}/files/{id} body: {restore:true}); a PATCH-equivalent MCP tool ships in Phase 6. Editor role required.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The workspace slug. Accepts either the bare slug or the org-prefixed form ('my-org/my-workspace') as shown in the dashboard URL. | |
| file_id | Yes | The file cuid (from list_files). |