- API >
- API Resources >
- Database Users
Database Users¶
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. This page uses the more familiar term group. The
endpoints are as stated on the page.
Base URL: https://cloud.mongodb.com/
The databaseUsers resource lets you retrieve, create and modify the
MongoDB users in your cluster. Each user has a set of roles that provide
access to the group’s databases. A user’s roles apply to all the clusters in
the group: if two clusters have a products database and a user has a role
granting read access on the products database, the user has that
access on both clusters.
Each user also has a username, password, and authentication database used to log into MongoDB. Atlas deployments of
MongoDB use admin as the authentication database for all users. The
authentication database does not determine a user’s roles.
The databaseUsers resource requires your Group ID.
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/atlas/v1.0/groups/{GROUP-ID}/databaseUsers | Get all users in the group |
GET |
/api/atlas/v1.0/groups/{GROUP-ID}/databaseUsers/admin/{USERNAME} | Get a single user in the group |
POST |
/api/atlas/v1.0/groups/{GROUP-ID}/databaseUsers | Create a user for the group |
PATCH |
/api/atlas/v1.0/groups/{GROUP-ID}/databaseUsers/admin/{USERNAME} | Update a user for the group. |
DELETE |
/api/atlas/v1.0/groups/{GROUP-ID}/databaseUsers/admin/{USERNAME} | Delete a user for the group. |