---
title: "Remove a member or org from a team"
method: DELETE
path: "/api/v1/teams/{team}/members"
---

# Remove a member or org from a team

`DELETE /api/v1/teams/{team}/members`

Removes a user, agent, or all members of an organization from the specified
team. Provide exactly one of `user`, `agent`, or `org` — supplying more than
one or none returns a 400 error. On success, returns 204 No Content.

When `org` is provided, every user and agent membership belonging to that org
is removed in a single call. The caller must be a member of the team's owning
org to perform an org-scoped removal. You cannot target the team's owning org
itself with this parameter.

The caller must have permission to manage the team. When `app` is present, the
request is scoped to that app and requires a valid app-scoped token.

## Path parameters

- `team` string, required

## Response `204`

No content

## Other responses

- `400` — Provide exactly one of user, agent, or org
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Team or member not found

---

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