Database Users


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:

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.