VOOZH about

URL: https://platform.claude.com/docs/en/manage-claude/admin-api-keys

⇱ Create an Admin API key - Claude API Docs


Create an Admin API key
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Every API in the Admin section of this guide (the Admin API, Analytics APIs, Compliance API, Spend Limits API, Usage and Cost API, and Rate Limits API) is authenticated with an Admin API key. You do not need a separate key for each API.

Where you create the key depends on which Claude product your organization uses.

Which key do you need?

Your organizationCreate the key inKey prefixWho can create itWorks with
Claude Console (Claude Platform, platform.claude.com)Claude Console > Settings > Admin keyssk-ant-admin01-...Organization members with the admin roleAdmin API, Usage and Cost API, Rate Limits API, , and the Compliance API

Was this page helpful?

Claude Code Analytics API
Activity Feed
Claude Enterprise (claude.ai)claude.ai > Organization settings > APIsk-ant-api01-...The organization's primary ownerCompliance API, Claude Enterprise Analytics API, and Spend Limits API, according to the scopes you select

A key created in one organization cannot be used to manage a different organization. If your company uses both Claude Console and Claude Enterprise, create one key in each.

Create a key for a Claude Console organization

  1. Sign in as an organization admin

    Only organization members with the admin role can create Admin API keys. See Organization roles and permissions.

  2. Open Admin keys settings

  3. Create the key

    Click Create key, give it a name, and click Create. Claude Console keys do not have selectable scopes; every key carries full Admin API access.

  4. Copy and store the secret

    Copy the displayed secret (starting with sk-ant-admin01-) and store it in your secrets manager. The full secret is shown only once.

Create a key for a Claude Enterprise organization

  1. Sign in as the primary owner

    Only the primary owner of the Claude Enterprise parent organization can create these keys.

  2. Open API settings

    Go to claude.ai > Organization settings > API and find the Keys section.

  3. Click + Create key

    Name the key and select the scopes you need from the scopes table. You can combine scopes from different APIs (for example, read:analytics and read:spend_limits) on a single key.

  4. Copy and store the secret

    Copy the displayed secret (starting with sk-ant-api01-) and store it in your secrets manager. The full secret is shown only once.

Choose scopes for a Claude Enterprise key

When you create a Claude Enterprise key, select every scope that the APIs you plan to call require. Scopes are fixed at creation; to add a scope later, create a new key.

To call...Select these scopes
Spend Limits API: read members' effective spend limits and increase requestsread:spend_limits
Spend Limits API: set or clear per-user spend limits; approve or deny increase requestswrite:spend_limits
Claude Enterprise Analytics API: engagement, adoption, cost, and usage reportsread:analytics
Compliance API Activity Feed: organization-wide activity eventsread:compliance_activities
Compliance API content endpoints: read chats, files, projects, and usersread:compliance_user_data
Compliance API content endpoints: delete chats, files, and projectsdelete:compliance_user_data
Compliance API organization endpoints: read organization metadata and settingsread:compliance_org_data, read:compliance_org_settings

The Compliance and Analytics APIs must be enabled for your organization before keys with those scopes can be used. See Get access to the Compliance API and Analytics APIs.

Use the key

Pass the key in the x-api-key header on every request. See each API's documentation for complete request examples.

A call that exceeds the key's scopes returns 403 Forbidden with a message listing the scopes the key has and the scopes the endpoint needs.

Next steps

Admin API

Manage organization members, workspaces, and API keys.

Spend Limits API

Set per-member spend limits and review increase requests for your Claude Enterprise organization.

Analytics APIs

Report on Claude Code productivity or Claude Enterprise engagement and adoption.

Compliance API

Audit activity and retrieve or delete user content across your organization.