---
title: "Remove an organization member"
method: DELETE
path: "/orgs/{identifier}/members/{userId}"
tags: ["My Organizations"]
---

# Remove an organization member

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

Removes a member from an organization. The caller (key owner) must be an organization admin. The organization owner cannot be removed this way - transfer ownership first. Requires orgs.roster:read-write.

## Path parameters

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

## Response `200`

Member removed.

- RemoveOrgMemberResponse
  - `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.

## Changes

- **2026-06-24** `fd9c94372431` — 1 info
  - endpoint added
- **2026-06-04** `f22bd61fd595` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/teambattles/apis/teambattles-api/changes/orgs/:identifier/members/:userId/delete.md)

---

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