API Keys

List API keys

Lists API keys accessible to the caller. A project-scoped credential sees only keys in its project; an account-scoped credential sees all keys in the account. Raw secrets are never returned.

get/v1/api-keys

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/api-keys
  • 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)

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

Response

A page of API keys.

next_cursorstring nullable required

Example response

{
  "data": [
    {
      "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.