Update a user's access level

Updates a user's access level on the account. The request includes account access and entity access roles.

  • Account access roles. These roles give access to account level operations, entities in the account both existing and to be created in the future, and creation of new entities.

  • Entity access roles. These roles provide access to specific entities that are already available on the account.

To learn more, see the Identity and Access in Cloud Manager glossary. This operation replaces any existing role assignment. To completely block user's access to the account, pass an empty list, []. To get the list of available roles, run the List available roles operation.

📘

Before you begin

Before you run this operation, read Comparison of Linode API for grants and Identity and Access to learn about the new experience and recommended use of the new Identity and Access endpoints.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • Identity and access permissions. Your user needs a role with these permissions. Learn more.
    • Permissions: update_user_permissions
Path Params
string
required

The username to look up.

string
enum
required

Enum Call the v4 URL.

Allowed:
Body Params
account_access
array of strings
required
length ≥ 0

Assigned account access roles.

account_access*
entity_access
array of objects
required
length ≥ 0

Encapsulates assigned entity access roles and entities they apply to.

entity_access*
Responses

Language
Credentials
Bearer
Response
Choose an example:
application/json