# GET /roles

**Resource:** [Roles & Permissions](./roles.md)  
**MCP tool:** `list_roles`  
**Scopes:** `permissions:read`  
**Write operation:** no

List all roles in this workspace (preset and custom) with their resolved scopes, data scope, visibility, and assigned-user counts.

## Request example

```bash
curl   "https://api.trustpager.com/functions/v1/api/v1/roles"   -H "Authorization: Bearer YOUR_API_KEY"
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`