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

# Delete a workspace

`DELETE /tenant/workspaces/{workspaceId}`

## Request

- Base URL: `https://api.savanto.ai`
- URL: `https://api.savanto.ai/tenant/workspaces/{workspaceId}`
- Auth: HTTP bearer

Permanently delete a workspace and every document indexed under it (products, posts, taxonomies, chat threads, crawl history). This is NOT recoverable — prefer `POST /workspaces` to create a new one rather than delete + recreate for routine cleanup. Returns 404 if the id does not belong to the caller's tenant.

## Path parameters

- `workspaceId` string, required

## Response `200`

Workspace deleted

- object
  - `object` 'workspace', required
  - `requestId` string, required
  - `data` object, required

## Other responses

- `207`: Workspace deleted with partial cleanup failures — inspect data.results
- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `413`: Payload too large
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/savanto/apis/savanto-api.md) · [All operations](https://skmtc.dev/savanto/apis/savanto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/savanto/apis/savanto-api/revisions/82437327a878?raw)