---
title: "Delete user"
method: DELETE
path: "/api/v1/users/{userID}"
tags: ["User"]
---

# Delete user

`DELETE /api/v1/users/{userID}`

Soft-delete a user - marking a user as deleted, without a possibility of reversing the deletion.

The following rules apply to user soft-deletion:

* A regular user can delete self and nobody else
* An organization admin can delete other users within the organization, including other admins
  * For trial organizations, the admin deleting self actually means the whole trial organization will be deleted
  * For non-trial organization
    * The last admin cannot be deleted via API, but must instead create a ticket with support
    * If the organization has an organization group admin, the admin can delete self but the org will be preserved
* An organization group admin
  * Cannot be deleted via API
  * Can remove any organization admin or regular user

## Path parameters

- `userID` integer, required

## Response `204`

No Content

## Other responses

- `400` — Invalid input data.
- `401` — The username/password is invalid or token is invalid (e.g. expired).
- `403` — Insufficient permission, missing authentication, invalid CSRF token and similar issue.
- `404` — The specified resource was not found.
- `409` — Conflict
- `429` — Request rate is too high, wait before sending more requests. See [Rate Limiting](/guides/overview#rate-limiting) for more details.
- `500` — Server failure while processing the request.
- `502` — Invalid response from the upstream server.
- `503` — We're temporarily offline for maintenance. Please try again later.
- `504` — Upstream server could not complete the request in time.

---

[API](https://skmtc.dev/rossum/apis/rossum-api.md) · [All operations](https://skmtc.dev/rossum/apis/rossum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rossum/rossum-api/revisions/f1b5a910991d/schema)