Delete a tool file
Permanently deletes the file’s bytes, its record and every share on it. Irreversible, and it takes the file away from everyone it was shared with. Audited as file.deleted.
Owner only: the person who ran the tool, not the owner of the connection behind it. Unlike the content route this one requires X-Organization-Id (it is a command, never a link someone clicks). A caller who is not the owner gets 403 ("Only the owner…") whenever the file is visible to them (an explicit share, or use on its source connection or toolbox, since it is in their GET /file); 404 for everyone else, including a malformed or unknown id, an expired file, and a member the file does not reach. A second delete of the same id is a 404.
Request
- Base URL: https://api.elaichi.ai
- URL: https://api.elaichi.ai/file/{id}
- Auth: HTTP bearer
Path parameters
File id (file_…).
Headers
Target organization (org_…). Required for cookie/session auth on org-scoped routes; optional for API tokens, which carry their organization, and rejected when it names a different one.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.