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

# Vaults

> `gcai vaults` commands.

## `gcai vaults list`

List vaults

```bash theme={null}
gcai vaults list [--limit <number>] [--offset <number>] [--search <value>]
```

| Flag                | Type     | Required | Description                                    |
| ------------------- | -------- | -------- | ---------------------------------------------- |
| `--limit <number>`  | `number` |          | Max items to return (default 100, max 500)     |
| `--offset <number>` | `number` |          | Number of items to skip (default 0)            |
| `--search <value>`  | `string` |          | Case-insensitive substring match on vault name |

Wraps `GET /vaults` — see [List vaults](/api-reference/list-vaults) for full parameter semantics.

## `gcai vaults get`

Get a vault

```bash theme={null}
gcai vaults get <id>
```

Wraps `GET /vaults/{id}` — see [Get a vault](/api-reference/get-vault) for full parameter semantics.

## `gcai vaults upload-document`

Add a document to a vault

```bash theme={null}
gcai vaults upload-document <id> <file>
```

Wraps `POST /vaults/{id}/documents` — see [Add a document to a vault](/api-reference/upload-vault-document) for full parameter semantics.