Delete role

Delete a custom role. System roles cannot be deleted. Ensure no users or API credentials are assigned the role before deleting.

Path Parameters

Parameter	Type	Required	Description
`id`	UUID	Yes	Role identifier

Use Cases

Remove obsolete custom roles
Clean up role structure
Consolidate roles

Required Permission

roles:delete

In the Wallet App

Go to Settings → Roles tab.
Find the custom role and click Delete.
Confirm the deletion. If users are still assigned to this role, reassign them first.

Note: System roles cannot be deleted.

Delete role

Delete a custom role. System roles cannot be deleted. Ensure no users or API credentials are assigned the role before deleting.

Path Parameters

Parameter	Type	Required	Description
`id`	UUID	Yes	Role identifier

Use Cases

Remove obsolete custom roles
Clean up role structure
Consolidate roles

Required Permission

roles:delete

In the Wallet App

Go to Settings → Roles tab.
Find the custom role and click Delete.
Confirm the deletion. If users are still assigned to this role, reassign them first.

Note: System roles cannot be deleted.