API Keys - Naïve

Create Key

POST /v1/auth/keys

string

Optional label for the key

string

Pin the key to a project. Omit it and the key is un-pinned: it acts inside whichever project the request names, falling back to the organization’s default. A pinned key handed a different project id answers 403 key_project_mismatch — it is never redirected into the named project.

{
  "api_key": "nv_sk_live_...",
  "key_id": "uuid",
  "name": "Production Key",
  "active_project_id": null,
  "created_at": "2026-05-02T..."
}

List Keys

GET /v1/auth/keys

{
  "keys": [
    {
      "id": "uuid",
      "name": "Default Key",
      "last_4": "****",
      "created_at": "2026-05-01T...",
      "last_used_at": "2026-05-02T...",
      "revoked": false
    }
  ]
}

Revoke Key

DELETE /v1/auth/keys/:id

{ "id": "uuid", "revoked": true }

{
  "api_key": "nv_sk_live_...",
  "key_id": "uuid",
  "name": "Production Key",
  "active_project_id": null,
  "created_at": "2026-05-02T..."
}