API Keys

Get an API key

Returns metadata for an API key. The raw secret is never returned after creation.

get/v1/api-keys/{api_key_id}

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/api-keys/{api_key_id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Response

API key metadata.

idstring required

Public API key ID (key_ prefix).

namestring required
key_prefixstring required

Leading characters of the raw key, for identification.

scope'project' | 'account' required

Whether the key is scoped to one project or the whole account.

project_idstring nullable

The project this key is scoped to; null for account-scoped keys.

capabilitiesstring[] required

Capabilities granted to this key. Empty means it inherits the creator's.

created_atstring date-time required
last_used_atstring date-time nullable

When the key was last presented; null if never used.

Example response

{
  "id": "key_V1StGXR8Z5jdHi6B",
  "name": "CI/CD Pipeline",
  "key_prefix": "nat_sk_a1b2c3",
  "scope": "project",
  "project_id": "proj_V1StGXR8Z5jdHi6B",
  "capabilities": [
    "agents:read",
    "sessions:write"
  ],
  "created_at": "2026-07-17T00:00:00.000Z",
  "last_used_at": "2026-07-17T09:12:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.