API Reference · API Keys

Mint an API key

The full secret is returned **once** and is never retrievable again.

POST/v1/tenants/{name}/keys

Authorization

x-api-keystringrequired
Your per-workspace API key, e.g. llc_AbC123…. Also accepted as Authorization: Bearer <key>. Mint keys on your workspace's API keys page — each key belongs to one workspace.

Path parameters

namestringrequired
Workspace (tenant) name.

Body

namestringoptional
e.g. ci-bot

Response

201The new key, including its one-time secret.

idstring
namestring
prefixstring
e.g. llc_AbC12…
roleenum
One of: tenant.
lastUsedAtstring · date-time
createdAtstring · date-time
keystring
e.g. llc_AbC123…
curl -X POST https://api.live-llm.com/v1/tenants/acme/keys \
  -H "x-api-key: $LIVELLM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ci-bot"
  }'
Try itPOSThttps://api.live-llm.com/v1/tenants/{name}/keys
Fill required path param: name.
Example response201
{
  "id": "…",
  "name": "…",
  "prefix": "llc_AbC12…",
  "role": "tenant",
  "lastUsedAt": "2026-01-01T12:00:00Z",
  "createdAt": "2026-01-01T12:00:00Z",
  "key": "llc_AbC123…"
}