---
title: "Set the caller's per-org BYOK key (website / Supabase-authenticated; write-only)"
method: POST
path: "/v1/byok"
tags: ["BYOK"]
---

# Set the caller's per-org BYOK key (website / Supabase-authenticated; write-only)

`POST /v1/byok`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/byok`
- Auth: none declared

## Headers

- `authorization` string, nullable
- `x-org-id` string, nullable

## Request body

- ByokRequest: Mirrors the website's payload shape (``provider``/``key``), distinct from the SDK's ``backend``/``api_key``. The website only sends ``anthropic`` today; other supported backends are accepted for forward-compatibility and validated downstream by the key store.
  - `provider` string
  - `key` string, required

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/codna/apis/algenta-api.md) · [All operations](https://skmtc.dev/codna/apis/algenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/codna/apis/algenta-api/revisions/35d30f84a5df?raw)