---
title: "Delete workspace"
method: DELETE
path: "/api/v3/meta/workspaces/{workspaceId}"
tags: ["Workspaces"]
---

# Delete workspace

`DELETE /api/v3/meta/workspaces/{workspaceId}`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/workspaces/{workspaceId}`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/workspaces/:workspaceId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a workspace.

**Note**: This endpoint is available on cloud-hosted **Business** plans and above, and on licensed self-hosted deployments (**Business** plan and above). Listing and creating workspaces is available on all plans; unlicensed self-hosted deployments are limited to the default workspace.

## Path parameters

- `workspaceId` string, required

## Response `200`

Workspace deleted successfully.

## Other responses

- `404`: Workspace not found.
- `500`: The server encountered an unexpected error while processing the request.

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)