# Delete a workspace

`DELETE /workspaces/{workspace_name}`

:::code-group
```bash title="cURL"
curl --request DELETE \
  --url https://api.pinecone.io/workspaces/{workspace_name} \
  --header 'Authorization: Bearer <token>'
```

```json title="401"
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "The request exceeds your project quota. Upgrade your account or adjust your project settings to increase the quota."
  },
  "status": 429
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Path Parameters

- `workspace_name` (path, string, required) — The name of the workspace to delete.

## Headers

- `X-Pinecone-Api-Version` (header, string, required) — Required date-based version header

## Response

- `202` — The request to delete the workspace has been accepted.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `403` — Forbidden. The API key does not have permission to perform this action, or a project limit (such as the maximum number of workspaces) has been reached.
- `404` — Workspace not found.
- `500` — Internal server error.

## Related pages

- [List workspaces](./control-plane-list-workspaces.md)
- [Create a workspace](./control-plane-create-a-workspace.md)
- [Describe a workspace](./control-plane-describe-a-workspace.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.