v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01176310978.7 KB
roles

Delete Role

Delete a role. Optionally, reassign existing users with that role to a new role.

delete/api/v1/roles/{role_id}

Path parameters

role_idinteger required

The ID of the role to delete

The ID of the role to delete

Query parameters

reasonstring required

The reason for deleting the role

The reason for deleting the role

new_role_idinteger nullable

Users with the deleted role will be reassigned to the new role, if a new role ID is provided

Users with the deleted role will be reassigned to the new role, if a new role ID is provided

Response

Successful Response

{"stackTrail":"paths:/api/v1/roles/{role_id}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}