My Teams

Transfer team captaincy

Changed on

Transfers team captaincy from the caller (key owner) to another active member, who becomes the new captain. The caller must currently be the team captain and is demoted to co-captain. Requires teams.roster:read-write.

post/teams/{identifier}/captaincy/transfer

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/teams/{identifier}/captaincy/transfer
  • Auth
    HTTP bearer

Path parameters

identifierstring required

Team slug or Convex team ID.

Request body

newCaptainIdstring required

Convex user ID of the active team member to promote to captain.

Response

Captaincy transferred.

successtrue required
timestampstring required

Response generation time (ISO 8601).

Changes