Post
/api/v1/roles.update
Update a role in the workspace.
Permission required: access-permissions
Changelog
| Version | Description |
|---|---|
| 6.0.0 | Moved to Enterprise plan. |
Header parameters
X-User-Id
stringRequired
The authenticated user ID.
ExamplerbAXPnMktTFbNpwtJ
X-Auth-Token
stringRequired
The authenticated user token.
ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
Body parameters
object
roleId
string Required
The role ID that you want to update.
Example646c431fa8c3a3ba32d0e1c4
name
string Required
The updated name of the role.
ExamplenewRole
scope
string
The updated scope of the role. The default value is Users.
ExampleSubscriptions
description
string
Updated description for the role.
ExampleRole description
mandatory2fa
boolean
Whether the role should have a mandatory 2FA. The default value is false.
Defaultfalse
Responses
200
400
401
OK
object
role
object
_id
string
name
string
scope
string
description
string
protected
boolean
mandatory2fa
boolean
_updatedAt
string
success
boolean