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 following resource creates a new Atlas user and assigns
it to one or more of your Atlas projects and organizations.

Atlas limits Atlas user membership to a maximum of 250
Atlas per team.

Atlas limits Atlas user membership to 500 Atlas users per
project and 500 Atlas users per organization, which includes the
combined membership of all projects in the organization.

Atlas raises an error if an operation would exceed any of the
stated limits.

Example

You have an organization with five projects. Each project has 100
Atlas users. Each Atlas user belongs to only one project.
You cannot add any Atlas users to this organization without
first removing existing Atlas users from the organization
membership.

Each object in the array represents either an Atlas
organization or
project the Atlas user is assigned to
and the Atlas role has for
the associated organization or project. You can specify eitherroles.orgId or roles.groupId per object.

roles.orgId

string

The unique identifier of the organization in which the user has the
specified roles.roleName.

roles.groupId

string

The unique identifier of the project in which the user has the
specified roles.roleName.

roles.roleName

string

The name of the role.

When associated to roles.orgId, the valid roles and their
mappings are:

One or more links to sub-resources and/or related resources. The
relation-types between URLs are explained in the
Web Linking Specification.

mobileNumber

string

The Atlas user’s mobile or cell phone number.

roles

object array

Each object in the array represents either an Atlas
organization or
project the Atlas user is assigned to
and the Atlas role has for
the associated organization or project. You can specify eitherroles.orgId or roles.groupId per object.

roles.orgId

string

The unique identifier of the organization in which the user has the
specified roles.roleName.

roles.groupId

string

The unique identifier of the project in which the user has the
specified roles.roleName.

roles.roleName

string

The name of the role.

When associated to roles.orgId, the valid roles and their
mappings are: