---
title: "set_byok_key"
method: POST
path: "/tools/set_byok_key"
tags: ["Account"]
---

# set_byok_key

`POST /tools/set_byok_key`

## Request

- Base URL: `https://compabase.com/api/mcp`
- URL: `https://compabase.com/api/mcp/tools/set_byok_key`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Add or update a BYOK provider API key. Encrypted at rest (AES-256-GCM).
Requires a paid plan (Pro or higher).

**Does not consume quota.**

Providers & key formats:
- `openai`: `sk-…` (OpenAI API key)
- `claude`: `sk-ant-…` (Anthropic Claude key)
- `gemini`: `AIza…` or `AQ.…` (Google AI Studio key)

**Example prompts:** "Set my OpenAI key to sk-proj-abc123..."

**Parameters:** `provider` (required), `api_key` (required).

## Response `200`

Key saved confirmation

- object

---

[API](https://skmtc.dev/compabase/apis/compabase-mcp.md) · [All operations](https://skmtc.dev/compabase/apis/compabase-mcp/llms.txt) · [OpenAPI document](https://skmtc.dev/compabase/apis/compabase-mcp/revisions/43169ccbb0f7?raw)