Who this is for: Owners and Primary Owners who create keys for the security, finance, or reporting tools that read their organization’s data.An admin API key lets a script read your organization’s Claude for Government audit events, usage reports, or both, without anyone signing in. Keys are read-only, and each one reads only the organization it was created in.
For a key that reads the audit events of every organization in your tenant, see Managing API keys for the Compliance API.
What a key can read
You choose what a key can read when you create it, and you can’t change the choice afterward. You can select a choice when your role allows it and its setting is on.
A key with Usage and cost reports can read each member’s usage and estimated cost, by the hour, with the member’s name and email address. Neither API returns conversation content, files, or anything your users type into Claude.
A key that reads only one of the APIs gets a 403 error from the other.
Create a key
Each organization can hold up to 50 active keys, whatever they read. Revoked keys don’t count toward the limit.- In the organization admin portal, go to Settings > Admin API keys.
- Under This key can read, make sure that Compliance activity feed, Usage and cost reports, or both are selected.
- Enter a name and click Create key.
- Copy the key and store it somewhere safe, then click Done.
Rotate or revoke a key
Keys never expire, and they aren’t tied to the person who created them. To stop a key when someone who has it changes role or leaves, revoke it.- Rotate a key without interrupting the tool that uses it: create a new key with the same choices under This key can read, switch the tool to it, confirm that data still arrives, and then revoke the old key.
- Revoke a key: go to Settings > Admin API keys in the organization admin portal, find the key by the last characters in its Key column, click Revoke in its row, and click Revoke in the dialog. Owners, Primary Owners, and tenant administrators can revoke any of the organization’s keys. Revoking takes effect immediately and can’t be undone, and the next request made with the key returns a 401 error.
- Rotate or revoke a key created in the tenant admin portal: a tenant administrator goes to Settings > Compliance API keys in the tenant admin portal and follows the same steps there. A new key there needs only a name.