---
title: "Delete a workspace"
method: DELETE
path: "/v2/workspaces/{workspaceId}"
tags: ["Workspaces"]
---

# Delete a workspace

`DELETE /v2/workspaces/{workspaceId}`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/workspaces/{workspaceId}`
- Auth: HTTP bearer

You can use this endpoint to delete an existing workspace by its workspaceId. **Caution:** Deleted workspaces cannot be recovered.

### Usage notes
- Retrieve the **workspaceId** by calling the [/v2/workspaces](https://help.sigmacomputing.com/reference/list-workspaces) endpoint.

### Usage scenarios
- **Cleanup operations**: Useful for removing workspaces that are no longer needed or relevant.
- **Resource management**: Helps in managing the overall resource allocation by removing unused workspaces.

### Best practices
- **Confirm before deletion**: Always ensure that deletion operations are preceded by explicit user confirmations to prevent accidental loss of data.
- **Audit and logging**: Maintain audit logs for deletion actions to track who deleted the workspace and when.

## Path parameters

- `workspaceId` string, required

## Response `200`

The response body.

- WorkspacesDeleteWorkspaceResponse200

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)