Bucket Object Delete Failed
bucket-object-delete-failed · 502
The bucket's store refused to delete the file, so the file is still there and nothing was recorded.
All pages
storeCode is the error code the store gave, null when it gave none. A file that was already gone isn't an error: deleting it succeeds.
Besides the members every error carries, this type adds code, bucketId, key and storeCode.
- The store was busy or failing at that moment.
- The store refused the key for a reason of its own, named in
storeCode.
- Retry the delete after a short wait: deleting a file twice is safe.
- If it keeps failing with the same
storeCode, tell the user, quotingdetail.
json
{
"type": "bucket-object-delete-failed",
"title": "Bucket Object Delete Failed",
"detail": "The store refused to delete 'uploads/report.pdf' from bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401'",
"code": "BUCKET_OBJECT_DELETE_FAILED",
"bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
"key": "uploads/report.pdf",
"storeCode": "InternalError",
"requestId": "req-1785231000000-4f7b2c9ae",
"timestamp": "2026-07-28T09:30:00.000Z",
"path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects",
"method": "DELETE",
"instance": "DELETE /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects",
"status": 502,
"docs": "https://ghaym.me/docs/errors/bucket-object-delete-failed"
}