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.
All pages
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.
- 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.
- 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.
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"
}