Change User Role

Documentation has been added to the Tenable Developer Portal for the Change role endpoint that enables customers to change the role assigned to a specific user. For more information about user roles within Tenable Vulnerability Management, see Roles in the Tenable Vulnerability Management User Guide.

The endpoint is described in the following table:

Endpoint	Name	Description
PUT /access-control/v1/users/{user_uuid}/roles	Change role	Changes the role for the specified user.

Example

To change the role for a user with the UUID 162a01a3-9de3-43f9-bed6-b4da34015d71 to a custom role with the UUID 3c6cc566-f13f-43ed-b403-12e14376e1f2, you could use the following cURL request:

curl --request PUT \
     --url https://cloud.tenable.com/access-control/v1/users/162a01a3-9de3-43f9-bed6-b4da34015d71/roles \
     --header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "role_uuids": [
    "3c6cc566-f13f-43ed-b403-12e14376e1f2"
  ]
}
'