Roles & Permissions
List Roles
Lists all roles (sanctum guard) with their permissions and a users_count.
Create Role
Creates a new role (guard_name is forced to 'sanctum') and syncs the given permissions.
Get Permissions (Grouped)
Returns the full permission catalog grouped by resource for the permission-matrix UI. Each group has a resource key, human label, icon, and its permissions.
Show Role
Returns a single role with its permissions and users_count.
Update Role
Updates an existing role and re-syncs its permissions.
Delete Role
Deletes a role. Users assigned the role lose its permissions.
Assign Roles to User
Syncs the Spatie roles assigned to a user (sanctum guard). Replaces the user's current roles with the provided list.
Bulk Update User Roles
Add or remove Spatie roles across many users at once (sanctum guard). Each user's other roles are left unchanged — this is NOT a sync/replace.