Management API Keys
Management API keys manage projects, budgets and model API keys, and query project and key usage across a Team account.
Management API keys manage projects, budgets and model API keys, and query project and key usage across a Team account.
Which key does each endpoint accept?
This comparison covers API keys. Where enabled, existing OAuth scoped tokens remain supported for billing queries.
Create a management key
- Sign in to Console and switch to a Team account where you are the Owner.
- Open Developer → Management API Keys in the sidebar, or go directly to the page. Only the current Team Owner sees this entry.
- Enter Name, optionally set Expires (optional), and click Create key.
- Click Copy key and save the new
mgmt-...credential asATLASCLOUD_MANAGEMENT_API_KEYfor the examples below. The secret is shown only once.
Where does api_key_id come from?
The api_key_id in a URL is the id returned by Create a model API key (POST /public/v1/api-keys), in ak_... format. Save it to disable or delete the key, set its allowance, or query its usage. The returned key (apikey-...) is for model calls; keep using mgmt-... in the authorization header for management calls.
For example, the creation response contains these fields:
{
"id": "ak_0123456789ABCDEFGHIJKL",
"key": "apikey-REPLACE_WITH_SECRET_RETURNED_ONCE"
}Put that same id in the path, for example /public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage. API_KEY_ID in the examples means this value. The Public API currently has no key list endpoint, so save id when creating the key.
Call the Public API
Send the management key in the Authorization: Bearer header. Requests use the Team account associated with that key.
curl -X POST "https://api.atlascloud.ai/public/v1/projects" \
-H "Authorization: Bearer $ATLASCLOUD_MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"customer-123"}'Step-by-step provisioning guide.
Manage the key
Disabled, deleted, or expired management keys cannot authenticate. Use the management page to enable or disable an unexpired key. Deletion cannot be undone.
Management keys belong to the Team and remain valid when their creator leaves or stops being Owner. The current Owner can manage keys issued by previous Owners. Disable or delete a key to revoke access.
Each Team can retain up to 5 undeleted management keys, including disabled and expired keys. Deleting a key frees a slot.
Last updated on