- API >
- API Resources
API Resources¶
Note
Groups and projects are synonymous terms. Your {GROUP-ID} is the
same as your project ID. For existing groups, your group/project ID
remains the same. The resource and corresponding endpoints use the
term groups.
The Atlas API provides the resources listed here. The resources give programmatic access to Atlas’s features. For information on the API’s principles and conventions, see API.
The Atlas API provides the following resources:
| Root | The starting point for the Atlas API. |
| Database Users | Retrieves and edits the MongoDB users who have access to your MongoDB clusters. |
| Custom MongoDB Roles | Retrieves and edits custom MongoDB roles, which specify a custom set of user privileges on your Atlas project. |
| Project IP Whitelist | Retrieves and edits the project IP whitelist, which controls client access to MongoDB clusters in a given Atlas project. |
| Organizations | Create, retrieve, or delete Atlas organizations. |
| Invoices | Retrieve invoices for any given Atlas organization. |
| Projects | Retrieves or creates projects in any given Atlas organization. |
| Clusters | Create, retrieve, update, or delete a cluster in a given Atlas project. Retrieve or update advanced cluster options for a cluster in a given Atlas project. |
| Global Clusters | Add, remove, and retrieve namespaces, and add and remove custom zone mappings associated with Global Clusters. |
| Alerts | Retrieves and acknowledges alerts. |
| Alert Configurations | Retrieves and edits alert configurations, which define the conditions that trigger alerts and the methods of notification. |
| Maintenance Windows | Retrieves and edits preferred maintenance windows. These windows set when you would prefer Atlas runs its regular maintenance. |
| LDAP Configuration | Create an LDAP configuration request for a Atlas project. |
| Continuous Backup Snapshots | Enables you to view snapshot metadata, edit snapshot expiration dates, and remove existing snapshots. A snapshot is a backup of your data captured at a specific point in time. |
| Continuous Backup Snapshot Schedule | View or edit the cluster’s backup snapshot schedule. |
| Continuous Backup Restore Job | Create and retrieve restores jobs for a MongoDB cluster. A restore job restores a MongoDB cluster to its state from an existing snapshot or a specific point-in-time. |
| Cloud Provider and On-demand Snapshots | View and delete backup snapshots for an Atlas . |
| Cloud Provider Snapshot Restore Job | Create or View restore jobs for an Atlas cluster with Cloud Provider Snapshots enabled. |
| Cloud Provider Snapshot Backup Policy | View and modify the snapshot schedule and retention settings for an Atlas cluster with Cloud Provider Snapshots enabled. |
| Checkpoints | Retrieve checkpoints metadata. Checkpoints are additional restore points for sharded clusters at points in time between regular snapshots. |
| VPC | API for managing VPC peering. |
| Personal API Key Whitelist | Retrieves and edits the API whitelist, which controls a user’s access to the Atlas API. |
| Programmatic API Keys | API for managing programmatic API keys. |
| Personal API Keys (Deprecated) | API for managing user personal API keys (deprecated). |
| Monitoring and Logs | Retrieve monitoring and logging data for MongoDB processes in a Atlas project. |
| Performance Advisor | Retrieve existing and suggested indexes for a deployment, as well as the namespaces on which slow queries were run and the queries that were slow. For more information on monitoring slow queries, see the Performance Advisor monitoring page. |
| Auditing | View or edit the project’s database auditing configuration. |
| Encryption at Rest | Enable, disable, configure, and retrieve configuration for Encryption at Rest. |
| Atlas Users | Create or manage Atlas users. |
| Events | Retrieve events for an Atlas organization or project. |