---
title: "Remove Users from Team"
method: POST
path: "/v1/teams/{id}/users/remove"
tags: ["Teams"]
---

# Remove Users from Team

`POST /v1/teams/{id}/users/remove`

Removes users from a specified team. With user permissions, the team must be one the requesting user has edit access to. With admin permissions, users can be removed from any team belonging to the account.

## Path parameters

- `id` number, required

## Headers

- `Lucid-Request-As` string

## Request body

- RemoveUsersFromTeamBody
  - `users` integer[], required — Array of IDs of users to remove from the team.

## Response `204`

No Content. The users were successfully removed from the team. If requesting as admin, users may be have been removed even if the authenticated user does not have direct access to the specified team.

## Other responses

- `400` — Bad Request. * if the user making the request attempts to remove all users from the team. * if not all the specified users are members of the team.
- `403` — Forbidden. * if the user making the request does not have permission to edit teams. * if the user making the request does not have access to the specified team. * if the team is managed via SCIM. Use the SCIM Groups API to modify SCIM-managed teams.

---

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