My Teams

Set a team member's role

Changed on

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

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/teams/{identifier}/members/{userId}/role
  • Auth
    HTTP bearer

Path parameters

identifierstring required

Team slug or Convex team ID.

userIdstring required

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).

Changes