Delete Object
Delete an object or folder from a bucket.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/objects | DELETE | No |
Deletes an object or folder from a bucket you own. Behavior depends on the bucket's versioning status.
Query Parameters
bucket
string required
Name of the bucket.
key
string required
Object key to delete. Use trailing
/ for folders (e.g., images/).Response
Returns 204 No Content on success.
Versioning Behavior
| Bucket Versioning | Key Type | Behavior |
|---|---|---|
| Disabled | File | Permanently deleted |
| Disabled | Folder | All objects with prefix are permanently deleted |
| Enabled | File | Creates a delete marker (object appears deleted but versions are preserved) |
| Enabled | Folder | All objects with prefix are permanently deleted |
| Suspended | File | Permanently deleted along with all versions |
| Suspended | Folder | All objects with prefix are permanently deleted |
When versioning is enabled, deleting an object creates a delete marker. The object appears deleted, but previous versions can still be accessed. Use the Delete Version endpoint to permanently remove specific versions.
Errors
| Status | Reason |
|---|---|
400 | Missing bucket or key parameter |
404 | Bucket not found (or not owned by you) |