Create an API key

:::callout amber Not available yet. The management API is documented ahead of its implementation — the request and response shapes below are a stable contract we're committing to, but calling these endpoints today returns 404. Manage keys in the dashboard in the meantime. The live gateway endpoints today are POST /v1/chat/completions, POST /v1/embeddings and GET /v1/models. :::

Create a new caller API key. The plaintext value of the key is returned exactly once in the response — routeur.ai only stores a hash. If you lose it, revoke and create a new one.

POST /v1/api-keys Coming soon

https://api.routeur.ai

Request body

name string required

Human label that appears in the dashboard and trace records, e.g. Production.

Returns

Status 201 with the new key metadata and the one-time key field.

← List API keys Revoke API key →

const res = await fetch("https://api.routeur.ai/v1/api-keys", { method: "POST", headers: { Authorization: `Bearer ${process.env.ROUTEUR_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ name: "Production" }) }); const created = await res.json();