Files
Delete file
Permanently delete a file from a workspace.
DELETE
Delete file
Permanently deletes a file from storage and removes its record from the workspace.
Deleting a file does not remove any copy that was pushed onto a computer. A file synced to
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.
/root/Desktop stays on that computer.
Errors
Every error carries the shape{"error": "<message>"}.
Compatibility parameter
Preferid. 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
API key authentication. Get your key at orgo.ai/workspaces
Query Parameters
File ID. Supply id or its compatibility alias fileId. If both are supplied they must match.
Compatibility alias for id. Prefer id.
Response
File deleted
Example:
true