add_site_role¶
Delegate access to a site to another user.
Parameters¶
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
site_url |
string | Yes | -- | The URL of your site |
delegated_url |
string | Yes | -- | The URL being delegated (usually the same as site_url) |
user_email |
string | Yes | -- | The email of the user to delegate access to |
authentication_code |
string | Yes | -- | The site's authentication code (from list_sites) |
is_administrator |
boolean | No | false |
Whether to grant administrator privileges |
is_read_only |
boolean | No | true |
Whether access should be read-only |
Response¶
{
"siteUrl": "https://www.example.com/",
"delegatedUrl": "https://www.example.com/",
"userEmail": "colleague@example.com",
"isAdministrator": false,
"isReadOnly": true,
"success": true,
"requestedAt": "2026-02-21T19:00:00Z"
}
Example Prompts¶
"Give colleague@example.com read-only access to my Bing Webmaster site."
Notes¶
- The recipient must accept the delegation from their own Bing Webmaster account before access is active.
- Use
get_site_rolesafterward to confirm the delegation appears (it may show as pending until accepted). - Use
remove_site_roleto revoke access later.