# Roles

LLMS index: [llms.txt](/llms.txt)

---

## Roles

**URL:** `/roles`

Roles (PSROLEDEFN) are named bundles of permission lists. Users get roles, not permission lists directly.

### What You Can Do

- **View Included Permission Lists:** See the list of permission lists assigned to the role.
- **View Assigned Users:** See which users are assigned this role.
- **Metadata Inspection:** See the role's description and last modified information.

### When It's Useful

- Understanding what an unfamiliar role grants.
- Checking whether a role contains permission lists that are unexpectedly broad.
- Finding all users who have a particular role.