Reference
members
An org's members and their roles. Index · shared schemas · errors.
| Procedure | Summary | REST | MCP tool | Stability |
|---|---|---|---|---|
members.list | List an org's members and their roles, oldest first | GET | — | experimental |
members.updateRole | Change a member's role. Trust class; owners only may grant or take away ownership. | POST | — | experimental |
members.remove | Remove a member from an org; their sessions lose its scopes on their next call. Trust class. | POST | — | experimental |
members.leave | Leave an org as the signed-in user (the last owner cannot leave) | POST | — | experimental |
members.list
List an org's members and their roles, oldest first
| REST | GET /v1/members/list (input as query parameters) |
| RPC | /rpc/v2/members/list |
| MCP | not a tool (a cloud platform procedure; the cloud MCP surface is the curated device tools); hints: read-only, idempotent |
| Auth | org:read |
| Tenancy | org |
| Troupe Cloud | answered by the control plane |
| Stability | experimental, since 1.0 |
Input:
{ orgId: OrgId; limit?: PageLimit; cursor?: PageCursor }Output:
{ members: Member[]; nextCursor?: string }Named types: Member, OrgId, PageCursor, PageLimit.
members.updateRole
Change a member's role. Trust class; owners only may grant or take away ownership.
| REST | POST /v1/members/update-role (input as a JSON body) |
| RPC | /rpc/v2/members/updateRole |
| MCP | not a tool (a cloud platform procedure; the cloud MCP surface is the curated device tools); hints: idempotent |
| Auth | org:manage; trust-class: locally only the runtime owner token; in the cloud only an interactive user session re-authenticated within 15 minutes; never an API key or an MCP token |
| Tenancy | org |
| Troupe Cloud | answered by the control plane |
| Stability | experimental, since 1.0 |
Input:
{ orgId: OrgId; userId: UserId; role: MemberRole }Output:
{ member: Member }Errors: U, NOT_FOUND, ORG_SUSPENDED, CONFLICT.
Named types: Member, MemberRole, OrgId, UserId.
members.remove
Remove a member from an org; their sessions lose its scopes on their next call. Trust class.
| REST | POST /v1/members/remove (input as a JSON body) |
| RPC | /rpc/v2/members/remove |
| MCP | not a tool (a cloud platform procedure; the cloud MCP surface is the curated device tools); hints: idempotent, destructive |
| Auth | org:manage; trust-class: locally only the runtime owner token; in the cloud only an interactive user session re-authenticated within 15 minutes; never an API key or an MCP token |
| Tenancy | org |
| Troupe Cloud | answered by the control plane |
| Stability | experimental, since 1.0 |
Input:
{ orgId: OrgId; userId: UserId }Output:
{ removed: boolean }Errors: U, NOT_FOUND, CONFLICT.
members.leave
Leave an org as the signed-in user (the last owner cannot leave)
| REST | POST /v1/members/leave (input as a JSON body) |
| RPC | /rpc/v2/members/leave |
| MCP | not a tool (a cloud platform procedure; the cloud MCP surface is the curated device tools); hints: idempotent, destructive |
| Auth | account:write |
| Tenancy | org |
| Troupe Cloud | answered by the control plane |
| Stability | experimental, since 1.0 |
Input:
{ orgId: OrgId }Output:
{ left: boolean }Errors: U, NOT_FOUND, CONFLICT.
Named types: OrgId.