Delete a workspace
Changed on⚠️ 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)
- Caller must be an OWNER of the workspace (or hold instance/company workspace-delete permission)
Request
- Base URLhttps://api.lighton.ai
- URLhttps://api.lighton.ai/api/v3/workspaces/{id}
- Auth
- HTTP bearer
- or none
Path parameters
The unique identifier of the workspace.
Response
Workspace soft-deleted
Changes
- info
added the media type
application/jsonfor the response with the status - info
added the media type
application/jsonfor the response with the status - info
added the media type
application/jsonfor the response with the status - info
added the non-success response with the status
- info