UpdateRoleRequest
The changes to a role; what is omitted stays.
object
position
The new rank of the role, from 0 to 999.
integer
permissions
The new permissions of the role, each once; empty removes them all.
Array<string>
badge
The new badge of the role. Its holders keep their choice to show it.
Schema: RoleBadge
object
remove_badge
true removes the badge of the role, and every holder’s choice to show it; a new badge
starts hidden. Sending it with badge is a 422 whose detail names remove_badge.
boolean
Example generated
{ "position": 1, "permissions": [ "manage_reports" ], "badge": {}, "remove_badge": true}For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt