Update a User Role
This endpoint updates user roles and privileges.
https://<tenant-name>.goskope.com/api/v1/role?op=update
Valid parameters are:
Key | Type | Value | Description |
---|---|---|---|
| string | Ex:
| Required. The token obtained from the REST API page in the Netskope UI ( Settings > Tools > Rest API v1) is required. We recommend that you place the token in the body of the request, not in the endpoint URL. |
| string |
| Required. Operation performed. |
| string | Ex:
| Required. Specifies role to be updated. |
| string | Ex:
| Required. Specifies new role name. |
| string | Ex:
| Required. Describes the role and abilities. |
| array |
| Required. Specifies functional areas with privilege value. |
| string |
| Optional. Allows admins to download, preview and view files from API-enabled Protection and Incident Management |
| array |
| Optional. Allows obfuscating file names and values. |
POST 'https://<tenant>/api/v1/role?token=token&op=update' \ --header 'Content-Type: application/json' \ --data-raw '{ "token": "f32a973eddd7bc1602fc0f48dc0a", "role_name": "Netskope Role", "role_desc": "Role Description", "privilege": [ { "name": "administrators", "value": "view" }, { "name": "threat", "value": "edit" } ], "scope_query": "account_id eq '215406114230'", "file_download": true, "obfuscate": [ { "name": "user", "value": false }, { "name": "app", "value": true } ] }'