# MongoDB Global Clusters API

**Canonical:** https://apis.io/apis/mongodb/mongodb-global-clusters-api/  
**Provider:** MongoDB — https://apis.io/providers/mongodb/  
**Base URL:** https://cloud.mongodb.com/api/atlas/v2  
**Documentation:** https://www.mongodb.com/docs/atlas/api/

MongoDB Global Clusters API is one of 53 APIs that [MongoDB](https://apis.io/providers/mongodb/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Global Clusters. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, rate-limit docs, and a changelog.

Returns, adds, and removes Global Cluster managed namespaces and custom zone mappings. Each collection in a Global Cluster is associated with a managed namespace. When you create a managed namespace for a Global Cluster, MongoDB Cloud creates an empty collection for that namespace. Creating a managed namespace doesn't populate a collection with data. Similarly, deleting a managed namespace doesn't delete the associated collection. MongoDB Cloud shards the empty collection using the required location field and a custom shard key. For example, if your custom shard key is `city`, the compound shard key is `location, city`. Each Global Cluster is also associated with one or more Global Writes Zones. When a user creates a Global Cluster, MongoDB Cloud automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. For example, a use case might require mapping a location code to a geographically distant zone. Administrators can manage custom zone mappings with the APIs below and the **Global Cluster Configuration** pane when you create or modify your Global Cluster.

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/mongodb/refs/heads/main/openapi/mongodb-global-clusters-api-openapi.yml
- **Documentation** — https://www.mongodb.com/docs/atlas/api/atlas-admin-api-ref/
- **Authentication** — https://www.mongodb.com/docs/atlas/api/api-authentication/
- **RateLimits** — https://www.mongodb.com/docs/atlas/api/api-rate-limit/
- **Versioning** — https://www.mongodb.com/docs/atlas/api/versioned-api-overview/
- **ChangeLog** — https://www.mongodb.com/docs/atlas/reference/api-resources-spec/changelog/
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/mongodb/refs/heads/main/graphql/mongodb-graphql.md

## Other MongoDB APIs (12)

- [MongoDB Atlas Data API](https://apis.io/apis/mongodb/mongodb-atlas-data-api/)
- [MongoDB Atlas App Services Admin API](https://apis.io/apis/mongodb/mongodb-atlas-app-services-admin-api/)
- [MongoDB Access Tracking API](https://apis.io/apis/mongodb/mongodb-access-tracking-api/)
- [MongoDB Activity Feed API](https://apis.io/apis/mongodb/mongodb-activity-feed-api/)
- [MongoDB Alert Configurations API](https://apis.io/apis/mongodb/mongodb-alert-configurations-api/)
- [MongoDB Alerts API](https://apis.io/apis/mongodb/mongodb-alerts-api/)
- [MongoDB Atlas Search API](https://apis.io/apis/mongodb/mongodb-atlas-search-api/)
- [MongoDB Auditing API](https://apis.io/apis/mongodb/mongodb-auditing-api/)
- [MongoDB AWS Clusters DNS API](https://apis.io/apis/mongodb/mongodb-aws-clusters-dns-api/)
- [MongoDB Cloud Backups API](https://apis.io/apis/mongodb/mongodb-cloud-backups-api/)
- [MongoDB Cloud Migration Service API](https://apis.io/apis/mongodb/mongodb-cloud-migration-service-api/)
- [MongoDB Cloud Provider Access API](https://apis.io/apis/mongodb/mongodb-cloud-provider-access-api/)

## Tags

Global Clusters

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mongodb/mongodb-global-clusters-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mongodb/.