Create a custom role
POST/api/v1/RolesRole
Creates a custom role with the name, description and target that you send. The role starts with no permissions, scope or members; add them with the other role routes. Use it to delegate part of administration to people who are not administrators.
Permission required: Administrator role.
Values for roleTarget: 0 = AccessPolicies, 1 = Credentials, 2 = Auditors.
Request
Responses
- 200
- 400
- 403
Returns the new role, including its ID.
A role with that name already exists, or the role could not be created.
The signed-in user does not have the required role, or the account has read-only administrator access.