> For the complete documentation index, see [llms.txt](https://docs.nebulablock.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nebulablock.com/api-reference/platform-api/list-workspaces/delete-bucket.md).

# Delete Bucket

Delete a bucket from a Nebula Block object storage workspace.

Delete a bucket from a workspace.

## HTTP Request

`DELETE` `{API_URL}/object-storage/bucket`

where `API_URL = https://api.nebulablock.com/api/v1`.

## Query Parameters

| Parameter             | Requirement | Type      | Description                                                                 |
| --------------------- | ----------- | --------- | --------------------------------------------------------------------------- |
| `object_storage_name` | Required    | `string`  | The workspace holding the bucket                                            |
| `bucket_name`         | Required    | `string`  | The bucket to delete                                                        |
| `team_id`             | Optional    | `integer` | Act on a team's storage instead of your own. See [Teams](/account/teams.md) |

## Response Attributes

#### data `list`

Always empty on this endpoint.

#### status `string`

`success` or `failed`.

#### message `string`

A description of the result.

> **Note:** Business failures on this endpoint are returned as **HTTP 200 with `"status": "failed"`** and an explanatory `message`. Check `status`, not just the HTTP status code.

## Example

#### Request

```bash
curl -X DELETE '{API_URL}/object-storage/bucket?object_storage_name=research-datasets&bucket_name=checkpoints' \
-H 'Authorization: Bearer {TOKEN}'
```

#### Response

```json
{
    "data": [],
    "message": "storage research-datasets has been deleted successfully.",
    "status": "success"
}
```

## See also

* [List Buckets](/api-reference/platform-api/list-workspaces/list-buckets.md)
* [Delete File](/api-reference/platform-api/list-workspaces/delete-file.md)