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

# Provider Keys Overview

> Manage AI provider API keys for use with Spotlight model proxy.

# Provider Keys

Provider keys allow you to securely store API credentials for AI model providers (like Anthropic) in the Shinzo Platform. These keys are encrypted at rest and used by the Spotlight model proxy to make requests on your behalf.

## Supported Providers

Currently supported providers:

| Provider  | Key Format       | Features                                 |
| --------- | ---------------- | ---------------------------------------- |
| Anthropic | `sk-ant-api03-*` | Claude models, streaming, token counting |

<Warning>
  **Subscription-based access is not supported.** Only API keys from the [Anthropic Console](https://console.anthropic.com/settings/keys) can be used. OAuth tokens from Claude subscriptions (e.g., Claude Pro/Team subscriptions with format `sk-ant-oat01-*`) are not compatible with Shinzo.
</Warning>

## Why Use Provider Keys?

**Security**: Store API keys encrypted in Shinzo instead of hardcoding them in your applications.

**Centralized Management**: Manage all your AI provider credentials in one place.

**Analytics**: When using stored provider keys with Spotlight, all API usage is automatically tracked and available in session analytics.

## Endpoints

| Method   | Endpoint                                                     | Description                         |
| -------- | ------------------------------------------------------------ | ----------------------------------- |
| `POST`   | [`/auth/provider_keys/test`](/api/provider-keys/test)        | Test a provider key without storing |
| `POST`   | [`/auth/provider_keys`](/api/provider-keys/save)             | Save an encrypted provider key      |
| `GET`    | [`/auth/provider_keys`](/api/provider-keys/list)             | List all provider keys              |
| `PUT`    | [`/auth/provider_keys/{keyUuid}`](/api/provider-keys/update) | Update a provider key               |
| `DELETE` | [`/auth/provider_keys/{keyUuid}`](/api/provider-keys/delete) | Delete a provider key               |