---
title: "Bulk Delete Users Action"
method: POST
path: "/management/v1/users/bulk_delete"
tags: ["Internal User management"]
---

# Bulk Delete Users Action

`POST /management/v1/users/bulk_delete`

Delete up to 500 users in one call, taking each out of every team it belongs to.
Same authorization as `/user/delete`: proxy admins may delete anyone, org admins
only users inside organizations they administer. Unknown body fields are a 422.

`data` holds one result per requested `user_id`, in request order. A row is
`success: false` with an `error` when the id is unknown, repeated in the request,
or outside the caller's scope. Rows that pass those checks are deleted together,
in one transaction, so either all of them go or none does.

Example curl:
```
curl --location 'http://0.0.0.0:4000/management/v1/users/bulk_delete'         --header 'Authorization: Bearer sk-1234'         --header 'Content-Type: application/json'         --data '{"user_ids": ["user-1", "user-2"]}'
```

## Headers

- `litellm-changed-by` string, nullable — Who the caller is acting for; recorded on the audit log entries this call writes.

## Request body

- BulkDeleteUserRequest — Body of `POST /management/v1/users/bulk_delete`.
  - `user_ids` string[], required

## Response `200`

Successful Response

- BulkDeleteUsersResponse — `{data: [...]}` with one `UserDeleteResult` per requested user, in request order.
  - `data` UserDeleteResult[], required
    - `user_id` string, required
    - `user_email` string, nullable
    - `success` boolean, required
    - `teams_removed` string[]
    - `error` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-30** `85ac4287140e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/management/v1/users/bulk_delete/post.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/ee3a9ebe33fd?raw)