v20

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

My Teams

Transfer team captaincy

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

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