---
title: "Remove users from teams in bulk"
method: POST
path: "/v2/teams/bulk/remove-user"
tags: ["BulkTeamOperations"]
---

# Remove users from teams in bulk

`POST /v2/teams/bulk/remove-user`

This endpoint removes multiple users from their respective teams in a single request. Each removal specifies the team ID and user ID. Use the Retrieve bulk team operation status endpoint to check the status of the operation.

## Request body

- V2BulkRemoveUsersRequest
  - `removeUsers` V2QuitTeamRequest[], required — A list of user removals. Each removal specifies the team and user IDs.
    - `teamId` string, required — A unique identifier for the team linked to the user.
    - `userId` string, required — The unique identifier of the user.

## Response `200`

The bulk remove operation has been submitted. Use BulkTeamStatus to check progress.

- V2BulkRemoveUsersResponse
  - `bulkId` string — Unique identifier for the bulk operation.
  - `status` 'BULK_OPERATION_SUBMITTED' | 'BULK_OPERATION_IN_PROGRESS' | 'BULK_OPERATION_COMPLETED' | 'BULK_OPERATION_FAILED'
  - `message` string — Success message for the operation.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)