Create an API key

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 Preview

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 →

curl -X POST https://api.routeur.ai/v1/api-keys \
  -H "Authorization: Bearer $ROUTEUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Production" }'

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();

r = requests.post(
    "https://api.routeur.ai/v1/api-keys",
    headers={"Authorization": f"Bearer {os.environ['ROUTEUR_KEY']}"},
    json={"name": "Production"},
)
created = r.json()

201 application/json

Response

{
  "id":         "key_01J...",
  "name":       "Production",
  "prefix":     "rtr_live_qF8…",
  "key":        "rtr_live_qF8…W2k",
  "created_at": "2026-05-29T11:05:00Z"
}