roles_list
List all roles in the company with pagination, including hierarchy and assignment counts.
Instructions
List all roles within the company.
Returns all roles with pagination support, including role hierarchy and assignment counts.
Workflow tips:
Shows role hierarchy with parent_role_id
Includes assignment and sub-role counts
Use pagination for companies with many roles
Cached for 15 minutes for better performance
Common use cases:
List all roles: {}
Paginated list: { "start": 0, "limit": 50 }
View role hierarchy and structure
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of items to return (default: 100, max: 500) | |
| start | No | Pagination start (default: 0) |