v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
League: Membership & Teams

Remove a league team

Removes an approved team from the league. Pending matches are cancelled and ready or accepted matches are forfeited by the removed team. Requires a personal or developer API key whose owner is currently a league ADMIN of the league in the path, with the league teams capability enabled on the key. League API access is gated at api_pro on the league owner's plan.

post/leagues/{identifier}/teams/{leagueTeamId}/remove

Path parameters

identifierstring required

League slug or Convex league ID.

League slug or Convex league ID.

leagueTeamIdstring required

Approved league team membership ID.

Approved league team membership ID.

Request body

reasonstring

Optional removal reason shown to the team's captain.

Response

The team was removed from the league.

successtrue required
timestampstring required

Response generation time (ISO 8601).