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

Changes

Changed in 2 of the 22 revisions of this API.11

Jun 24, 2026fd9c943724311See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 4, 2026f22bd61fd5951See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 377 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history