# MongoDB Atlas Administration API OpenAPI file: https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview.json ## Description This is version `2.0` of this API documentation. Last update on Jul 8, 2026. The MongoDB Atlas Administration API allows developers to manage all components in MongoDB Atlas. The Atlas Administration API supports OAuth2 Service Accounts and HTTP Digest-based API keys. Service accounts are the recommended authentication method and API keys are considered a legacy option. To authenticate with a Service Account, first exchange its client ID and secret for an access token using the OAuth 2.0 Client Credentials flow. Atlas provides a token endpoint at `POST https://cloud.mongodb.com/api/oauth/token`, which returns a Bearer token that is reusable and valid for 1 hour (3600 seconds). For example, to [return a list of your organizations](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgs) with [cURL](https://en.wikipedia.org/wiki/CURL), first generate an access token and then use that token to call the same Atlas Administration API endpoint shown in the current example: ``` ACCESS_TOKEN=$(curl -fsS --request POST https://cloud.mongodb.com/api/oauth/token \ --header "Authorization: Basic $(printf '%s' "${CLIENT_ID}:${CLIENT_SECRET}" | base64 | tr -d '\n')" \ --header "Content-Type: application/x-www-form-urlencoded" \ --header "Accept: application/json" \ --data "grant_type=client_credentials" | jq -r '.access_token') curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \ --header "Accept: application/vnd.atlas.preview+json" \ -X GET "https://cloud.mongodb.com/api/atlas/v2/orgs?pretty=true" ``` If your organization requires an IP access list for the Atlas Administration API, the token can be created from any IP address, but the API call that uses the token must originate from an allowed IP. To learn more, see [Get Started with the Atlas Administration API](https://www.mongodb.com/docs/atlas/configure-api-access/). For support, see [MongoDB Support](https://www.mongodb.com/support/get-started). You can also explore the various endpoints available through the Atlas Administration API in MongoDB's [Postman workspace](https://www.postman.com/mongodb-devrel/workspace/mongodb-atlas-administration-apis/) (requires a Postman account). ## Servers - https://cloud.mongodb.com: https://cloud.mongodb.com () ## Authentication The API accepts 2 different authentication methods: - - ## Topics - [Rate Limiting](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/topic/topic-rate-limiting.md) ## Groups and operations ### [AI Model API Keys](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/group/endpoint-ai-model-api-keys.md) - [Return AI Model API Keys for One Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-listgroupaimodelapikeys.md) - [Create New AI Model API Key](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-creategroupaimodelapikey.md) - [Return Single AI Model API Key for One Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-getgroupaimodelapikey.md) - [Delete Existing AI Model API Key](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-deletegroupaimodelapikey.md) - [Update Existing AI Model API Key](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-updategroupaimodelapikey.md) - [Return AI Model API Keys for One Organization](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-listorgaimodelapikeys.md) - [Return Single AI Model API Key for One Organization](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-getorgaimodelapikey.md) ### [AI Model Rate Limits](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/group/endpoint-ai-model-rate-limits.md) - [Return AI Model Rate Limits for One Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-listgroupaimodelapiratelimits.md) - [Return Single AI Model Rate Limit for One Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-getgroupaimodelapiratelimit.md) - [Update AI Model Rate Limit](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-updategroupaimodelapiratelimit.md) - [Reset AI Model Rate Limit for One Model Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-resetgroupaimodelapiratelimit.md) - [Reset AI Model Rate Limits for Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-resetgroupaimodelapiratelimits.md) - [Return AI Model Rate Limits for One Organization](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-listorgaimodelapiratelimits.md) - [Return Single AI Model Rate Limit for One Organization](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-getorgaimodelapiratelimit.md) ### [Limit Description](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/group/endpoint-limit-description.md) - [Return Descriptions of User-Configurable Project Limits](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-listdefaultgrouplimits.md) - [Return One User-Configurable Project Limit and Description](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-getdefaultgrouplimit.md) [Powered by Bump.sh](https://bump.sh)