set_sensitivity_labels
Apply Microsoft Purview sensitivity labels to Power BI reports, semantic models, and dashboards to classify and protect items by label ID and name.
Instructions
Apply Microsoft Purview information protection sensitivity labels to items.
Use this tool when the user asks to:
Classify or protect Power BI items (reports, semantic models, dashboards).
Set Purview sensitivity labels (Confidential, General, Highly Confidential).
Args: items: List of dicts specifying item IDs and types (e.g. [{"id": "...", "type": "Report"}]). label_id: Microsoft Purview label GUID. label_name: Display name of the sensitivity label. admin_scopes: Optional list of administrative authorization scopes. redact_names: Whether to redact item names in returned logs for security. auth_mode: Optional auth mode ("interactive", "service_principal", "managed_identity"). tenant_id: Optional Azure AD tenant ID. client_id: Optional Azure AD client ID. dry_run: If True, validate permissions without applying labels. fabric_admin_client: Optional injected admin bridge/client (for testing).
Returns: Dict with updated items, failed items, and compliance status.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"items": "<items>",
"label_id": "<label_id>",
"label_name": "<label_name>"
},
"name": "set_sensitivity_labels"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| dry_run | No | ||
| label_id | Yes | ||
| auth_mode | No | ||
| client_id | No | ||
| tenant_id | No | ||
| label_name | Yes | ||
| admin_scopes | No | ||
| redact_names | No | ||
| fabric_admin_client | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||