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

# ankra ai

> Manage AI provider settings and the model catalog

## ankra ai

Configure the organisation's AI provider, credentials, custom
OpenAI-compatible endpoints, and the model catalog the chat picker offers.

Mutations require the ai.manage permission (organisation admins by default);
the provider status and the model listing are available to every member.

## ankra ai anthropic

Manage the custom Anthropic API key

## ankra ai anthropic delete

Remove the custom Anthropic API key

```bash theme={null}
ankra ai anthropic delete [flags]
```

**Flags**

| Flag    | Default | Description                  |
| ------- | ------- | ---------------------------- |
| `--yes` | `false` | Skip the confirmation prompt |

## ankra ai anthropic set

Store and validate a custom Anthropic API key (must start with sk-ant-).

```bash theme={null}
ankra ai anthropic set [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--api-key`      |         | Anthropic API key (starts with sk-ant-)               |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra ai endpoints

Manage custom OpenAI-compatible endpoints

## ankra ai endpoints create

Add a named OpenAI-API-standard endpoint (OpenRouter, vLLM, LiteLLM,
Ollama, ...). The server validates and probes the endpoint before saving; the
API key is stored server-side and never returned.

```bash theme={null}
ankra ai endpoints create [flags]
```

**Flags**

| Flag             | Default | Description                                                                                    |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------- |
| `--api-key`      |         | API key for the endpoint                                                                       |
| `--base-url`     |         | OpenAI-compatible base URL (e.g. [https://openrouter.ai/api/v1](https://openrouter.ai/api/v1)) |
| `--name`         |         | Endpoint name                                                                                  |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable)                                          |

## ankra ai endpoints delete

Delete an endpoint and its stored key. Catalog models on it are removed too.

```bash theme={null}
ankra ai endpoints delete <endpoint_id> [flags]
```

**Flags**

| Flag    | Default | Description                  |
| ------- | ------- | ---------------------------- |
| `--yes` | `false` | Skip the confirmation prompt |

## ankra ai endpoints discover

Query the endpoint's /models list so you know which model ids to reference.

```bash theme={null}
ankra ai endpoints discover <endpoint_id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra ai endpoints list

List configured OpenAI-compatible endpoints

```bash theme={null}
ankra ai endpoints list [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra ai endpoints update

Update an endpoint's name, base URL, and optionally rotate its key.
Omit --api-key to keep the stored key.

```bash theme={null}
ankra ai endpoints update <endpoint_id> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--api-key`      |         | New API key (omit to keep the stored key)             |
| `--base-url`     |         | OpenAI-compatible base URL                            |
| `--name`         |         | Endpoint name                                         |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra ai models

Manage the organisation model catalog

## ankra ai models create

Add a model to the catalog.

For an Ankra-managed Claude model pass --model-id (e.g. claude-opus-4-8). For a
model served by a custom OpenAI-compatible endpoint, also pass --endpoint with
the endpoint id (see 'ankra ai endpoints list').

```bash theme={null}
ankra ai models create [flags]
```

**Flags**

| Flag                  | Default  | Description                                                   |
| --------------------- | -------- | ------------------------------------------------------------- |
| `--context-window`    | `200000` | Context window in tokens                                      |
| `--description`       |          | Short description                                             |
| `--enabled`           | `true`   | Model is selectable in the picker                             |
| `--endpoint`          |          | OpenAI-compatible endpoint id (omit for Ankra-managed Claude) |
| `--key`               |          | Catalog key (lowercase slug; the model\_mode value)           |
| `--max-output`        | `8192`   | Maximum output tokens                                         |
| `--model-id`          |          | Provider model id (e.g. claude-opus-4-8 or gpt-4o)            |
| `--name`              |          | Display name shown in the picker                              |
| `-o`, `--output`      |          | Output format: json or yaml (default: human-readable)         |
| `--sort-order`        | `0`      | Sort order in the picker (lower first)                        |
| `--supports-images`   | `false`  | Model accepts image inputs                                    |
| `--supports-thinking` | `false`  | Model supports a thinking/reasoning channel                   |
| `--supports-tools`    | `true`   | Model supports tool calling                                   |
| `--tier`              |          | Auto-routing tier: expert, think, quick, or empty             |

## ankra ai models delete

Delete a catalog model

```bash theme={null}
ankra ai models delete <id|key> [flags]
```

**Flags**

| Flag    | Default | Description                  |
| ------- | ------- | ---------------------------- |
| `--yes` | `false` | Skip the confirmation prompt |

## ankra ai models list

List the catalog models the chat picker offers

```bash theme={null}
ankra ai models list [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra ai models reset

Revert the catalog to the built-in defaults

```bash theme={null}
ankra ai models reset [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |
| `--yes`          | `false` | Skip the confirmation prompt                          |

## ankra ai models update

Update a catalog model addressed by its row id or catalog key.

Only the flags you pass are changed; the rest keep their current values.
Editing a built-in default the first time materialises the catalog.

```bash theme={null}
ankra ai models update <id|key> [flags]
```

**Flags**

| Flag                  | Default  | Description                                                   |
| --------------------- | -------- | ------------------------------------------------------------- |
| `--context-window`    | `200000` | Context window in tokens                                      |
| `--description`       |          | Short description                                             |
| `--enabled`           | `true`   | Model is selectable in the picker                             |
| `--endpoint`          |          | OpenAI-compatible endpoint id (omit for Ankra-managed Claude) |
| `--key`               |          | Catalog key (lowercase slug; the model\_mode value)           |
| `--max-output`        | `8192`   | Maximum output tokens                                         |
| `--model-id`          |          | Provider model id (e.g. claude-opus-4-8 or gpt-4o)            |
| `--name`              |          | Display name shown in the picker                              |
| `-o`, `--output`      |          | Output format: json or yaml (default: human-readable)         |
| `--sort-order`        | `0`      | Sort order in the picker (lower first)                        |
| `--supports-images`   | `false`  | Model accepts image inputs                                    |
| `--supports-thinking` | `false`  | Model supports a thinking/reasoning channel                   |
| `--supports-tools`    | `true`   | Model supports tool calling                                   |
| `--tier`              |          | Auto-routing tier: expert, think, quick, or empty             |

## ankra ai openai

Manage the legacy single OpenAI-compatible endpoint configuration.

For multiple endpoints and per-model routing prefer 'ankra ai endpoints' and
'ankra ai models'; this command configures the single legacy endpoint the
'openai\_compatible' provider uses.

## ankra ai openai delete

Remove the legacy OpenAI-compatible endpoint

```bash theme={null}
ankra ai openai delete [flags]
```

**Flags**

| Flag    | Default | Description                  |
| ------- | ------- | ---------------------------- |
| `--yes` | `false` | Skip the confirmation prompt |

## ankra ai openai set

Store the legacy OpenAI-compatible endpoint

```bash theme={null}
ankra ai openai set [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `--api-key`      |         | API key for the endpoint                              |
| `--base-url`     |         | OpenAI-compatible base URL                            |
| `--model`        |         | Model id to use                                       |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra ai provider

Set the active AI provider for the organisation.

ankra              Ankra-managed Claude models (the default).
anthropic          Your own Anthropic API key (set it first with 'ankra ai anthropic set').
openai\_compatible  Your OpenAI-compatible endpoint (set it first with 'ankra ai openai set').

```bash theme={null}
ankra ai provider <ankra|anthropic|openai_compatible> [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |

## ankra ai status

Show the active AI provider and configured credentials

```bash theme={null}
ankra ai status [flags]
```

**Flags**

| Flag             | Default | Description                                           |
| ---------------- | ------- | ----------------------------------------------------- |
| `-o`, `--output` |         | Output format: json or yaml (default: human-readable) |