Tools
files_delete
PERMANENTLY delete a file and its stored bytes — destructive and irreversible.
PERMANENTLY delete a file and its stored bytes — destructive and irreversible. Refused (CONFLICT) while the file is attached to a post; to remove media from a post without destroying the file, use posts_update with a new media list instead.
Input
| Field | Type | Required | Description |
|---|---|---|---|
organization | string | no | Organization slug to act in (see organizations_list). Optional: API keys are bound to one organization; OAuth connections default to your active organization. |
id | string | yes | File id (file_…) |
Result
JSON on success. A refusal comes back as an error prefixed with its code (NOT_FOUND, FORBIDDEN, TOO_MANY_REQUESTS, …) and a message written to be acted on — read it before retrying.
The same operation elsewhere
This tool and the REST operation filesDelete and the CLI command inklate files delete run the same guarded procedure the dashboard uses — same permissions, same validation, same tenant isolation.