Delete Object

Delete an object or folder from a bucket.
EndpointMethodAdmin Required
/api/v1/objectsDELETENo

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 VersioningKey TypeBehavior
DisabledFilePermanently deleted
DisabledFolderAll objects with prefix are permanently deleted
EnabledFileCreates a delete marker (object appears deleted but versions are preserved)
EnabledFolderAll objects with prefix are permanently deleted
SuspendedFilePermanently deleted along with all versions
SuspendedFolderAll 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

StatusReason
400Missing bucket or key parameter
404Bucket not found (or not owned by you)

Download Objects

Download single files or multiple files as a ZIP archive.

List Versions

List all versions of a specific object.