---
title: "Delete a user (soft delete with history retention)"
method: DELETE
path: "/api/v1/scim/v2/Users/{user_id}"
tags: ["scim"]
---

# Delete a user (soft delete with history retention)

`DELETE /api/v1/scim/v2/Users/{user_id}`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/api/v1/scim/v2/Users/{user_id}`
- Auth: none declared

Soft-delete a user per SCIM 2.0 DELETE semantics.

SCIM clients expect DELETE to remove the resource. This server marks the
principal inactive while retaining its history in the chain, as declared
in ServiceProviderConfig. The 204 response signals successful removal to
the client; the ledger records the deprovisioning event.

## Path parameters

- `user_id` string, required

## Response `204`

Successful Response

## Other responses

- `404`: Unknown principal
- `422`: Validation Error

---

[API](https://skmtc.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)
