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

# Workspace tools

> MCP tools to manage workspaces

Manage the workspaces that hold ingested data.

## list\_workspaces

Lists the workspaces available to the authenticated account.

| Parameter | Type      | Description                                                                                                              |
| --------- | --------- | ------------------------------------------------------------------------------------------------------------------------ |
| `limit`   | `integer` | Optional. Maximum number of items to return per page. Defaults to `20`, maximum `100`. See [Pagination](/pagination).    |
| `cursor`  | `string`  | Optional. Opaque cursor pointing to the page to fetch. Omit to start from the first page. See [Pagination](/pagination). |

## create\_workspace

Creates a workspace.

| Parameter | Type     | Description                            |
| --------- | -------- | -------------------------------------- |
| `name`    | `string` | Human-readable name for the workspace. |

## get\_workspace

Retrieves a single workspace.

| Parameter | Type     | Description                      |
| --------- | -------- | -------------------------------- |
| `id`      | `string` | ID of the workspace to retrieve. |

## update\_workspace

Updates a workspace.

| Parameter | Type     | Description                    |
| --------- | -------- | ------------------------------ |
| `id`      | `string` | ID of the workspace to update. |
| `name`    | `string` | New name for the workspace.    |

## delete\_workspace

Deletes a workspace.

| Parameter | Type     | Description                    |
| --------- | -------- | ------------------------------ |
| `id`      | `string` | ID of the workspace to delete. |