v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Buckets

Delete Bucket

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).
delete/v1/buckets/{bucket_identifier}

Path parameters

bucket_identifierstring required

Query parameters

force_forecloseboolean

Response

Successful Response

{"stackTrail":"paths:/v1/buckets/{bucket_identifier}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}