---
title: "Admin Delete User"
method: DELETE
path: "/users/{user_id_or_username}"
tags: ["Users"]
---

# Admin Delete User

`DELETE /users/{user_id_or_username}`

Permanently (hard) delete a user account. Requires the explicit ``delete_user`` permission.

Removes the ``users`` row, which the ``on_user_delete`` DB trigger archives into
``deleted_users`` and which CASCADEs ``api_keys``/``jobs``/``logos``/``chute_shares``/
``oauth_*``. Deletion requires: no special roles (``permissions_bitmask`` is 0), a balance
within +/-25, and no owned chutes/images/secrets (those have ``NO ACTION`` FKs and must be
removed manually first, via their own endpoints). Financial history
(``admin_balance_changes``, ``payments``) has no FK and is preserved.

## Path parameters

- `user_id_or_username` string, required

## Headers

- `X-Chutes-Hotkey` string, nullable
- `X-Chutes-Signature` string, nullable
- `X-Chutes-Nonce` string, nullable
- `Authorization` string, nullable

## Request body

- UserDeletionRequest
  - `reason` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/chutes/apis/fastapi.md) · [All operations](https://skmtc.net/chutes/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chutes/fastapi/versions/352418d4e3a2/schema)