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.

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.

Common causes

  • The store was busy or failing at that moment.
  • The store refused the key for a reason of its own, named in storeCode.

How to fix the call

  • Retry the delete after a short wait: deleting a file twice is safe.
  • If it keeps failing with the same storeCode, tell the user, quoting detail.

Example response

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"
}