Skip to main content
DELETE
Delete file
Permanently deletes a file from storage and removes its record from the workspace.
This action cannot be undone. Signed download URLs issued for the file before deletion stop working.

Query parameters

string
required
File ID, as returned by the list or upload endpoints. Omitting it returns 400.

Response

boolean
Always true. Any failure is reported as an error status, not as false.

Example

Response

The stored object is removed first, then the file record. If removing the object fails, the endpoint returns 500 and the record is left in place. The file still appears in the list endpoint. Retry the delete.
Deleting a file does not remove any copy that was pushed onto a computer. A file synced to /root/Desktop stays on that computer.

Errors

Every error carries the shape {"error": "<message>"}.

Authorizations

Authorization
string
header
required

API key authentication. Get your key at orgo.ai/workspaces

Query Parameters

id
string
required

File ID, from GET /files. Required; omitting it is a 400.

Response

File deleted

success
boolean
Example:

true