v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
My Teams

Set a team member's role

Sets a team member's role to CO_CAPTAIN or MEMBER. The caller (key owner) must be the team captain or co-captain. The captain role cannot be assigned or removed this way - use captaincy transfer instead. Requires teams.roster:read-write.

patch/teams/{identifier}/members/{userId}/role

Path parameters

identifierstring required

Team slug or Convex team ID.

Team slug or Convex team ID.

userIdstring required

Convex user ID of the member whose role is changing.

Convex user ID of the member whose role is changing.

Request body

role'CO_CAPTAIN' | 'MEMBER' required

The new role for the member. Captaincy is changed via captaincy transfer.

Response

Member role updated.

successtrue required
timestampstring required

Response generation time (ISO 8601).