Docs Menu
Docs Home
/ /
Atlas CLI
/ / /

atlas api mongoDbCloudUsers removeProjectRole

On this page

  • Syntax
  • Options
  • Inherited Options

experimental: Removes one project-level role from the MongoDB Cloud user.

You can remove a role from an active user or a user that has been invited to join the project. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting API Key must have the Project Owner role. Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. This command is invoking the endpoint with OperationID: 'removeProjectRole'. For more information about flags, format of --file and examples, see: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeProjectRole

Command Syntax
atlas api mongoDbCloudUsers removeProjectRole [options]
Name
Type
Required
Description

--envelope

false

flag that indicates whether Application wraps the response in an envelope JSON object

--file

string

false

path to the file which contains the api request contents

--groupId

string

true

unique 24-hexadecimal digit string that identifies your project

-h, --help

false

help for removeProjectRole

--output

string

false

preferred api format, can be ["json", go-template] This value defaults to "json".

--output-file

string

false

file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip)

--pretty

false

flag that indicates whether the response body should be in the prettyprint format

--userId

string

true

unique 24-hexadecimal digit string that identifies the pending or active user in the project

--version

string

false

api version to use when calling the api call [options: "2043-01-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2043-01-01".

Name
Type
Required
Description

-P, --profile

string

false

Back

removeOrganizationRole