list_dataverse_roles
Retrieve security roles from Dataverse with filtering options to discover available permissions, find custom roles, and understand permission structures across business units.
Instructions
Retrieves a list of security roles in the Dataverse environment with filtering options. Use this to discover available roles, find custom roles, or get an overview of permission structures. Supports filtering by business unit, custom/system roles, and managed/unmanaged status.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| businessUnitId | No | Filter roles by business unit ID | |
| customOnly | No | Whether to list only custom (non-system) roles | |
| filter | No | OData filter expression | |
| includeManaged | No | Whether to include managed roles | |
| top | No | Maximum number of roles to return (default: 50) |
Input Schema (JSON Schema)
{
"properties": {
"businessUnitId": {
"description": "Filter roles by business unit ID",
"type": "string"
},
"customOnly": {
"default": false,
"description": "Whether to list only custom (non-system) roles",
"type": "boolean"
},
"filter": {
"description": "OData filter expression",
"type": "string"
},
"includeManaged": {
"default": false,
"description": "Whether to include managed roles",
"type": "boolean"
},
"top": {
"description": "Maximum number of roles to return (default: 50)",
"type": "number"
}
},
"type": "object"
}