API Keys

{
  "title": "Forbidden",
  "detail": "This API key is scoped to the data plane (recommend / respond). Management endpoints require a first-party session, an MCP connection, or an API key minted with the \"control-plane\" scope."
}

curl -X POST https://playground.kaireonai.com/api/v1/api-keys \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "name": "CI Pipeline Key",
    "expiresAt": "2027-01-01T00:00:00Z"
  }'

curl -X POST https://playground.kaireonai.com/api/v1/api-keys \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "name": "Infra Automation Key",
    "scopes": ["control-plane"]
  }'

curl -X POST https://playground.kaireonai.com/api/v1/api-keys \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: my-tenant" \
  -d '{
    "name": "Okta SCIM Provisioner",
    "scopes": ["scim"]
  }'

{
  "id": "clx...",
  "name": "CI Pipeline Key",
  "key": "krn_a1b2c3d4e5f6...",
  "prefix": "krn_a1b2c3d4",
  "scopes": [],
  "expiresAt": "2027-01-01T00:00:00.000Z",
  "createdAt": "2026-03-18T12:00:00.000Z",
  "warning": "Store this key securely. It will not be shown again."
}

{
  "data": [
    {
      "id": "clx...",
      "name": "CI Pipeline Key",
      "prefix": "krn_a1b2c3d4",
      "scopes": [],
      "expiresAt": "2027-01-01T00:00:00.000Z",
      "lastUsedAt": "2026-03-17T09:30:00.000Z",
      "createdAt": "2026-03-18T12:00:00.000Z"
    }
  ],
  "total": 1
}