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>"}.

Compatibility parameter

Prefer id. The older fileId spelling is also accepted as an alias. If both are present with different values the request returns 400. At least one is required.

Authorizations

Authorization
string
header
required

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

Query Parameters

id
string

File ID. Supply id or its compatibility alias fileId. If both are supplied they must match.

fileId
string

Compatibility alias for id. Prefer id.

Response

File deleted

success
boolean
Example:

true