> 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-workspace.md).

# Delete Storage Workspace

Delete an object storage workspace and invalidate its access keys.

Delete an object storage workspace.

## HTTP Request

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

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

## Query Parameters

| Parameter             | Requirement | Type      | Description                                                                 |
| --------------------- | ----------- | --------- | --------------------------------------------------------------------------- |
| `object_storage_name` | Required    | `string`  | The workspace 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:** Deleting a workspace that is already deleted succeeds rather than erroring, with the message `"storage <name> has been already deleted."` — so the call is safe to retry.

> **Important:** Deleting a workspace invalidates its access key pair. Anything still using those credentials will stop authenticating.

## Example

#### Request

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

#### Response

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

## See also

* [List Storage Workspaces](/api-reference/platform-api/list-workspaces.md)
* [Delete Bucket](/api-reference/platform-api/list-workspaces/delete-bucket.md)