DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

Update role

put
https://cloud.tenable.com/access-control/v1/roles/

Updates the specified custom role.

Requires the Administrator [64] user role or the TIO_BACKEND.ACCESS_CONTROL.MANAGE custom role privilege. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Specifies the unique identifier (UUID) of the role.

Body Params
string

Specifies the updated name for the role.

string

Specifies the updated description for the role.

role_permission_strings
array of strings

Specifies the custom role privilege strings to assign to the role. This replaces the existing permission set. For a list of supported permission strings, use the List role permissions endpoint. For more information, see Roles.

role_permission_strings
string

Specifies the role type.

string

Specifies the status of the role. Supported values are ENABLED and DISABLED.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

403

Returned if you do not have permission to update roles. For more information, see Roles and Permissions.

Updated about 17 hours ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html

Updated about 17 hours ago