Workspaces

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)
delete/api/v3/workspaces/{id}

Request

  • Base URL
    https://api.lighton.ai
  • URL
    https://api.lighton.ai/api/v3/workspaces/{id}
  • Auth
    • HTTP bearer
    • or none

Path parameters

idinteger required

The unique identifier of the workspace.

Response

Workspace soft-deleted

Changes

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status