# MongoDB Atlas Administration API ## Description This is version `2.0` of this API documentation. Last update on Apr 3, 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: - Digest auth (http) - Service accounts (oauth2) ## Topics - [Rate Limiting](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/topic/topic-rate-limiting.md) ## Endpoints and operations ### [Atlas](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/group/endpoint-atlas.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) - [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 Rate Limits for One Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-listgroupaimodelratelimits.md) - [Return Single AI Model Rate Limit for One Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-getgroupaimodelratelimit.md) - [Update AI Model Rate Limit](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-updategroupaimodelratelimit.md) - [Reset AI Model Rate Limit for One Model Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-resetgroupaimodelratelimit.md) - [Reset AI Model Rate Limits for Group](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-resetgroupaimodelratelimits.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) - [Return AI Model Rate Limits for One Organization](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-listorgaimodelratelimits.md) - [Return Single AI Model Rate Limit for One Organization](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/preview/operation/operation-getorgaimodelratelimit.md) [Powered by Bump.sh](https://bump.sh)