team_members_update

Management

Update Team Member Roles

Change the team role of one or more members (bulk). Requires a team admin (OAuth) or a team-scoped API key with the team.members.manage scope; other credentials get a permission error. Args: - team_id: required - member_ids: required — 1-32 member user IDs (from team_members_list) - role: required — 'admin' or 'member', applied to every listed member - response_format: optional — 'json' (default) or 'markdown' Returns: per-member outcome rows (updated | failed | skipped). Demoting the last admin fails server-side. API keys are refused — use api_key_update / api_key_delete for project-scoped keys, or the Scenario portal. Processes members one by one and reports a per-member outcome. If the response has status "partial", call the tool again with the "remaining" list to finish. Don't use when: Changing project roles — use project_members_update.

open-world

Parameters

Name	Type	Required	Description
team_id	string	✓	Team ID. Get it from teams_list.
project_id	string	—	Tenant context for OAuth sessions only.
member_ids	array	✓	Member user IDs to update (1-32). Get them from team_members_list.
role	enum(admin \| member)	✓	New team role applied to every listed member.
response_format	enum(json \| markdown)	json	Output format: 'json' for structured data, 'markdown' for human-readable text.