v3

latestOpenAPI 3.0.12026-07-31240345599.7 KB
Custom user roles

Update custom user role

Updates the details of a custom user role.

  • The user should have admin role and custom user role right.
put/api/{cloudId}/v1/roles/{identifier}

Path parameters

identifierstring required

Id of the custom user role.

Id of the custom user role.

Query parameters

identifierType'id' | 'name'

Type of the identifier.

Type of the identifier.

Request body

idstring

The id of the custom user role.

namestring

The name of the custom user role.

grantedRightsstring[]

The list of rights to grant to the custom user role.

disallowedRightsstring[]

The list of rights to disallow to the custom user role.

Example request

{
  "name": "conflictRightRole_1",
  "grantedRights": [
    "alerts-access-all",
    "incident-add-note",
    "asdasdad"
  ],
  "disallowedRights": [
    "incident-reopen"
  ]
}

Response

Returned if the request is successful.

messagestring