Docs Menu

Docs HomeMongoDB Atlas

Custom Roles

The customDBRoles resource lets you retrieve, create, and change custom roles in your cluster. Use custom roles to specify custom sets of actions that the Atlas built-in roles can't describe.

The following statements describe custom roles:

  • You define custom roles at the project level, for all clusters in the project.

  • The customDBRoles resource supports a subset of MongoDB privilege actions. For a complete list of privilege actions available for this resource, see Custom Role actions.

  • Using the Atlas Administration API, you can create a subset of custom role actions. To create a wider list of custom role actions, use the Atlas user interface.

  • Custom roles must include actions that all project's clusters support, and that are compatible with each MongoDB version used by your project's clusters. For example, if your project has MongoDB 4.2 clusters, you can't create custom roles that use actions introduced in MongoDB 4.4.


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.

Get all custom roles in the project.
Get the custom role named {ROLE-NAME}.
Create a new custom role in the project.
Update a custom role in the project.
Delete a custom role from the project.
←  Delete a Database UserGet All Custom Roles in a Project →
Share Feedback
© 2023 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.