Bucket Folder Deleting

bucket-folder-deleting · 409

A folder delete is running over this path, so the API refused to write into it or delete from it.

prefix is the folder being deleted. Uploads into it, and deletes of it, of a file in it or of a folder around it, wait until it ends; the rest of the bucket works as usual.

Besides the members every error carries, this type adds code, bucketId and prefix.

Common causes

  • A file was uploaded into a folder while the folder was being deleted.
  • A file in the folder was deleted while the folder delete was running.
  • A folder delete was started over the same folder, or one inside it or around it.

How to fix the call

  • Follow the folder delete with GET /v1/buckets/<id>/folder-deletes, and retry once it has ended.
  • Upload the file to another folder if it can't wait.

Example response

json
{
  "type": "bucket-folder-deleting",
  "title": "Bucket Folder Deleting",
  "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is deleting 'uploads/2025/'",
  "code": "BUCKET_FOLDER_DELETING",
  "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "prefix": "uploads/2025/",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads",
  "method": "POST",
  "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/bucket-folder-deleting"
}