Create an own key

Creates a key the tenant owns. 409 when the name equals a product key or an own key, or when `max_keys` is reached (`planLimit`).

Authorization

BearerAuthObject

AuthorizationBearer <token>

Machine tokens only: a personal API token or a product robot token (POST /api/v2/products/{uid}/robot-tokens). A session JWT here is 401 — the web app uses the b2t_access cookie.

In: header

Path Parameters

tenantId*string

UUID of the tenant

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

context?string|null

translations?array<>

Response Body

`application/json`

curl -X POST "https://example.com/api/v2/tenants/497f6eca-6276-4993-bfeb-53cbbbba6f08/extra-keys" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": 12,  "name": "Promo.Title",  "context": "Hero banner",  "translations": [    {      "languageId": 1,      "destination": "Hello"    }  ],  "createdAt": "2026-11-07 10:00:00",  "updatedAt": "2026-11-07 10:00:00"}

Empty

{  "message": {    "error": "Your request was made with invalid credentials."  }}

{  "message": {    "error": "You are not allowed to perform this action."  }}

Empty

Create an own key

Authorization

Path Parameters

Request Body

Response Body

201application/json

400

401application/json

403application/json

409

`application/json`

`application/json`

`application/json`