API Keys¶

Manage API keys programmatically. See Authentication for key types and rotation.

Create a key¶

POST /v1/keys

Request body

{
  "type": "live",
  "project_id": "proj_01HZ1"
}

Response

{
  "id": "key_123",
  "type": "live",
  "secret": "nimbus_live_sk_...",
  "created_at": "2026-06-18T12:00:00Z"
}

Secret shown once

The secret field is only ever returned in this create response. Store it immediately — Nimbus cannot show it to you again.

GET /v1/keys

Returned keys never include the secret field.

POST /v1/keys/{key_id}/rotate

The old key remains valid for 24 hours; see Authentication → Rotating keys.

DELETE /v1/keys/{key_id}