Workspaces

List Workspaces

GET /v1/kb/workspaces

Returns all workspaces owned by the current user.

Scope: kb:read

Create Workspace

POST /v1/kb/workspaces

Scope: kb:write

{
  "name": "Q4 Reports"
}

Get Workspace

GET /v1/kb/workspaces/{id}

Scope: kb:read

Update Workspace

PATCH /v1/kb/workspaces/{id}

Scope: kb:write

{
  "name": "Updated Name"
}

Get Workspace Stats

GET /v1/kb/workspaces/{id}/stats

Returns document count, total size, and processing status.

Scope: kb:read

Scan Workspace

GET /v1/kb/workspaces/{id}/scan

Returns a detailed scan of the workspace index, including chunk counts and embedding status.

Scope: kb:read

Delete Workspace

DELETE /v1/kb/workspaces/{id}

Permanently deletes the workspace and all its documents. This action cannot be undone.

Scope: kb:write