Grant roles to existing users in workspaces. Accepts up to 100 assignments of
{ workspaceId, userEmail, roleId }; each is processed independently and the
response reports per-assignment success or failure. You can only add users to
workspaces you have access to yourself. Use list_roles to discover role IDs.
| Parameter |
Type |
Required |
Description |
assignments |
AddUserToWorkspaceAssignment[] |
Yes |
Role assignments to apply (max 100). Each is processed independently; the response reports per-assignment success or failure. - AddUserToWorkspaceAssignment |
| Field |
Type |
Required |
Description |
workspaceId |
string |
Yes |
ID of the workspace to grant the role in. You can only add users to workspaces you have access to yourself — assignments for other workspaces are rejected. |
userEmail |
string |
Yes |
Email of an existing user to grant the role to (case-insensitive). Must be visible in a workspace you can access; need not already be a member of the target workspace (they are added if not). |
roleId |
string |
Yes |
ID of the role to grant. Use list_roles to discover the available roles and their IDs. |
| Field |
Type |
Description |
content |
ContentItem[] |
Array of content items returned by the tool - ContentItem |
isError |
boolean |
Whether the tool execution resulted in an error |
| Field |
Type |
Description |
type |
'text' |
Content type (currently only ‘text’ is supported) |
text |
string |
The text content to display |