---
title: "Add Byok Profile"
method: POST
path: "/api/ai-settings/byok"
tags: ["auth"]
---

# Add Byok Profile

`POST /api/ai-settings/byok`

## Request

- Base URL: `https://board.noddle.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://board.noddle.dev/api/ai-settings/byok`
- Auth: none declared

## Request body

- ByokProfileBody: POST /api/ai-settings/byok. ``name`` ≤ 40 chars, ``provider`` ∈ claude|openai|gemini|openrouter|custom. The raw ``api_key`` is stored obfuscated and only ever echoed back masked.
  - `name` string
  - `provider` string
  - `api_key` string
  - `model` string
  - `api_base` string

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/noddle/apis/noddle-board.md) · [All operations](https://skmtc.dev/noddle/apis/noddle-board/llms.txt) · [OpenAPI document](https://skmtc.dev/noddle/apis/noddle-board/revisions/7f324e389516?raw)