DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

Create role

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

Creates a custom role with the specified permissions.

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…
Body Params
string
required

Specifies the name for the custom role.

string

Specifies a description for the custom role.

role_permission_strings
array of strings
required

Specifies the custom role privilege strings to assign to the role. 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. For custom roles, use CUSTOM.

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 create 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