---
title: "Set or rotate a per-tenant provider/engine key (BYOK; stored encrypted, never returned)"
method: POST
path: "/v1/provider-keys"
tags: ["Account"]
---

# Set or rotate a per-tenant provider/engine key (BYOK; stored encrypted, never returned)

`POST /v1/provider-keys`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/provider-keys`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Request body

- SetProviderKeyRequest
  - `backend` string, required: Provider backend (e.g. 'anthropic', 'openai', 'google_genai') or 'engine' for the Algenta engine key.
  - `api_key` string, required: The provider/engine API key. Stored encrypted at rest; never returned.

## 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)