roles_list
Retrieve all company roles with pagination, hierarchy details, and assignment counts for structured role management.
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 |
|---|---|---|---|
| start | No | Pagination start (default: 0) | |
| limit | No | Number of items to return (default: 100, max: 500) |