--- search: tags: - administration - GET seo: description: >- What are Roles? Roles define what users can see and do in the workspace.… Reference for the GET /administration/roles endpoint in the Leadtime Public API API. sidebar: badge: GET label: List roles title: List roles type: openapi-operation --- **What are Roles?** Roles define what users can see and do in the workspace. Each role has a set of permissions that control access to features like creating projects, managing tasks, viewing reports, and more. **What is returned:** This endpoint returns all roles available in the workspace, including: - **Base roles**: System-defined roles that cannot be modified (Root, CEO, Team Leader, Staff, Guest) - **Custom roles**: User-created roles that can be edited and deleted **Role properties:** - Each role includes name, description, icon, and type (normal or guest) - The readOnly flag indicates if a role is a base role (cannot be modified) - Parent role relationships show permission inheritance hierarchy - Roles are returned in the user's preferred language **Use cases:** - Display role selection dropdowns in user management interfaces - Show available roles when assigning permissions to users - Build role management interfaces that distinguish between base and custom roles