Users and roles
Delete a role
DELETE/api/v1/admin/roles/:name
Who can use this: Site adminsAs Markdown
The role goes completely: every account that had it loses it at once, along with the permissions it carried.
Parameters
| Name | Where | What it is |
|---|---|---|
| name required | path | The role's name.e.g. auditor |
Good to know
- The built-in
user,site_adminandsystem_agentroles are protected; deleting one answers 400. - An unknown role answers 404.