set_member_role
Change a member's role (Admin+; last-owner protected) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the members:write permission).
Change a member's role (Admin+; last-owner protected).
| Required permission | members:write |
| Capability ID | members.setRole |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
role | OWNER | ADMIN | MEMBER | GUEST | VIEWER | yes | |
userId | string (uuid) | yes |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"OWNER",
"ADMIN",
"MEMBER",
"GUEST",
"VIEWER"
]
},
"userId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"role",
"userId"
],
"additionalProperties": false
}Access control
A call succeeds only when the personal access token's scopes and the holder's role both allow members:write (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.
set_active_workspace
Set the active workspace for the session/principal — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the workspace:read permission).
transfer_ownership
Transfer organization ownership to another member (Owner only) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the org:transfer permission).