---
title: "Delete Bucket"
method: DELETE
path: "/v1/buckets/{bucket_identifier}"
tags: ["Buckets"]
---

# Delete Bucket

`DELETE /v1/buckets/{bucket_identifier}`

This endpoint deletes a bucket and all its resources including:
    - S3 objects and blobs
    - Running Ray jobs (cancels active batch processing jobs)
    - Batch processing artifacts
    - Upload files
    - Unique key lookups
    - MongoDB metadata

    The deletion is performed **asynchronously** via a background task.
    Returns immediately with a task_id that can be polled via GET /v1/tasks/{task_id}.

    **Response**:
    - `task_id`: Use this to poll deletion status via GET /v1/tasks/{task_id}
    - `status`: Initial status (PENDING)
    - `bucket_id`: The bucket being deleted
    - `bucket_name`: Name of the bucket
    - `object_count`: Number of objects that will be deleted

    **Polling**:
    Poll GET /v1/tasks/{task_id} until status is COMPLETED or FAILED.
    Use exponential backoff (start 1s, max 30s).

## Path parameters

- `bucket_identifier` string, required

## Query parameters

- `force_foreclose` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/04b379bdbb7c/schema)