ExtraKey

Edit the context of an own key

Sets the context of the key (what the AI and translators read about it). `null`, `""` or whitespace clears it; at most 2000 characters. Every other body field is ignored — the name is never changed. The same value again writes nothing; a change writes one history row. `context` missing from the body → 400.

PATCH
/api/v2/tenants/{tenantId}/extra-keys/{keyId}

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
keyId*integer

Id of the own key

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/v2/tenants/497f6eca-6276-4993-bfeb-53cbbbba6f08/extra-keys/0" \  -H "Content-Type: application/json" \  -d '{    "context": "Hero banner on the landing page"  }'
{  "id": 12,  "name": "Promo.Title",  "context": "Hero banner on the landing page",  "translations": [    {      "languageId": 1,      "destination": "Hello"    }  ],  "createdAt": "2026-11-11 10:00:00",  "updatedAt": "2026-11-11 10:05:00"}
Empty
{  "message": {    "error": "Your request was made with invalid credentials."  }}
{  "message": {    "error": "You are not allowed to perform this action."  }}
{  "message": {    "error": "Page not found"  }}
Empty