user_roles_get_list
Retrieve a filtered list of user roles from ServiceTitan by applying criteria such as active status, creation date, employee type, or name. Supports pagination and total count inclusion for efficient role management.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| active | No | What kind of items should be returned (only active items will be returned by default) Values: [True, Any, False] | |
| createdBefore | No | Format - date-time (as date-time in RFC3339). Return items created before certain date/time (in UTC) | |
| createdOnOrAfter | No | Format - date-time (as date-time in RFC3339). Return items created on or after certain date/time (in UTC) | |
| employeeType | No | Filter roles by employee type Values: [None, Employee, Technician, All] | |
| ids | No | Perform lookup by multiple IDs (maximum 50) | |
| includeTotal | No | Whether total count should be returned | |
| name | No | Filters records by name (case-insensitive 'contains' operation) | |
| page | No | Format - int32. The logical number of page to return, starting from 1 | |
| pageSize | No | Format - int32. How many records to return (50 by default) | |
| tenant | Yes | Format - int64. Tenant ID |