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

# Delete a workspace

`DELETE /api/v3/workspaces/{id}`

⚠️ **ALPHA ENDPOINT** - This endpoint is in alpha and subject to breaking changes. Use with caution in production environments.

Soft-delete a custom workspace you own.

The workspace and its memberships are marked as deleted but retained for the configured recovery period; collection data (documents, chunks, embeddings) is preserved until the workspace is permanently deleted by the cleanup task. The workspace can be restored within the recovery period via `PATCH` with `deleted_at=null` (use `?include_deleted=true` to address it after deletion).

**Restrictions:**
- PERSONAL workspaces cannot be deleted (system-managed) — returns 403
- Caller must be an OWNER of the workspace (or hold instance/company workspace-delete permission)

## Path parameters

- `id` integer, required

## Response `204`

Workspace soft-deleted

## Other responses

- `401` — Unauthenticated - Missing or invalid API key/session cookie
- `403` — Forbidden - System-managed workspace or caller lacks owner permission
- `404` — Not Found - Workspace does not exist

---

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