Delete File
DELETE/api/v1/storage/:file_id
Delete a completed stored file by id, removing its object from storage.
Only the uploader or a workspace owner or manager may delete a file. An upload still pending or failed has no final object to remove; the expired-upload cleanup task discards those.
The caller's role and credentials are rechecked under locks held until the row is committed, so a demotion or revocation cannot land mid-delete. A file a queued or running geofence import still reads is refused with 409. The object is purged shortly afterwards by a queued task, with a scheduled sweep as the backstop.
Request
Responses
- 204
- 400
- 401
- 403
- 404
- 409
- 422
- 500
- 503
No Content
Bad Request
Unauthorized
Forbidden
Not Found
Conflict
Validation Error
Internal Server Error
Service Unavailable