Delete a company workspace

curl --request DELETE \
  --url https://api.lighton.ai/api/v3/company/workspaces/{id} \
  --header 'Authorization: Bearer <token>'

Workspaces

Delete a company workspace

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

Soft-delete a custom workspace in your company.

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 and COMPANY workspaces cannot be deleted (system-managed) — returns 403
Caller must have permission to delete workspaces in their company

DELETE

api

company

workspaces

{id}

Delete a company workspace

curl --request DELETE \
  --url https://api.lighton.ai/api/v3/company/workspaces/{id} \
  --header 'Authorization: Bearer <token>'

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

integer

required

The unique identifier of the workspace.

Response

Workspace soft-deleted

Retrieve a company workspace Update a company workspace

⌘I

Overview

Endpoints

Delete a company workspace

Authorizations

Path Parameters

Response

Overview

Endpoints

Documentation Index

Authorizations

Path Parameters

Response