pbi_add_role_member
Add or update a user or group as a member of a Power BI role, with support for external and Windows identity types. Option to overwrite existing members or detect duplicates.
Instructions
Add (or update) a member (user/group) on a role.
member_type: 'external' (default, ExternalModelRoleMember — recommended for Power BI service) 'windows' (WindowsModelRoleMember — domain principal SID)
With overwrite=False (default), raises PowerBIDuplicateError if a
member with the same member_name already exists on the role. With
overwrite=True the existing member's identity_provider is refreshed
(when external) and the response carries action="updated".
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": {
"role": "<role>",
"member_name": "<member_name>"
},
"name": "pbi_add_role_member"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | ||
| overwrite | No | ||
| member_name | Yes | ||
| member_type | No | external | |
| identity_provider | No | AzureAD |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |