> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qalico.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces

> Create, list, and delete workspaces

# Workspaces

Workspaces are the top-level container for regulatory data. Each workspace has its own profile, subscriptions, and updates.

## List workspaces

<ParamField header="X-API-Key" type="string" required>
  Your API key
</ParamField>

```bash theme={null}
GET /api/workspaces
```

Returns all workspaces the API client has access to.

**Response:**

```json theme={null}
[
  { "id": "abc-123", "name": "Acme Medical" },
  { "id": "def-456", "name": "MedTech Corp" }
]
```

## Create workspace

```bash theme={null}
POST /api/workspaces
```

<ParamField body="name" type="string" required>
  Workspace name
</ParamField>

Creates a workspace with chat and regulatory watch features enabled, profile in onboarding-completed state.

**Response** (`201`):

```json theme={null}
{ "id": "abc-123", "name": "Acme Medical" }
```

## Delete workspace

```bash theme={null}
DELETE /api/workspaces/:workspaceId
```

<Warning>
  This permanently deletes the workspace and all its data. This cannot be undone.
</Warning>

**Response** (`204`): No content.