---
title: "Delete a workspace"
method: DELETE
path: "/api/v1/workspaces/{workspace_id}"
tags: ["🏢 Workspaces"]
---

# Delete a workspace

`DELETE /api/v1/workspaces/{workspace_id}`

Soft-deletes a workspace and schedules permanent removal. The owner of the only default workspace cannot delete it.

## Path parameters

- `workspace_id` string, required

## Response `200`

Workspace deleted successfully

- object
  - `status` boolean
  - `message` string

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - No permission to delete this workspace
- `404` — Workspace not found
- `422` — Workspace cannot be deleted
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1.md) · [All operations](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/contentstudio/contentstudio-api-v1/revisions/ec0c85521883/schema)