---
title: "Remove a team member"
method: DELETE
path: "/teams/{identifier}/members/{userId}"
tags: ["My Teams"]
---

# Remove a team member

`DELETE /teams/{identifier}/members/{userId}`

Removes a member from a team, or removes yourself to leave it. To remove another member, the caller (key owner) must be the team captain or co-captain; any member may remove themselves. The team captain cannot be removed this way - disband the team or transfer captaincy first. Requires teams.roster:read-write.

## Path parameters

- `identifier` string, required — Team slug or Convex team ID.
- `userId` string, required — Convex user ID of the member to remove.

## Response `200`

Member removed.

- RemoveTeamMemberResponse
  - `success` true, required
  - `timestamp` string, required — Response generation time (ISO 8601).

## Other responses

- `401` — Missing or invalid API key.
- `403` — API key lacks the required permission.
- `404` — Resource not found.
- `429` — Rate limited.
- `500` — Internal server error.

---

[API](https://skmtc.net/teambattles/apis/teambattles-api.md) · [All operations](https://skmtc.net/teambattles/apis/teambattles-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teambattles/teambattles-api/versions/2ffe8fb53b7d/schema)