---
title: "Delete a User"
method: DELETE
path: "/scim/v2/Users/{user_id}"
tags: ["SCIM"]
---

# Delete a User

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

## Request

- Base URL: `https://api.byndid.com`
- URL: `https://api.byndid.com/scim/v2/Users/{user_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api/docs/scim/v2/Users/:user_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

To delete a user, send a DELETE request to `/Users/$USER_ID`.
As specified in [RFC-7644 §3.6](https://datatracker.ietf.org/doc/html/rfc7644#section-3.6),
a successful delete operation returns HTTP status 204 (No Content).
If the resource does not exist, HTTP status 404 is returned.

Note that deleting a user:
- Is permanent and cannot be undone
- Will remove all associated authentication data
- Will remove the user from all groups

## Path parameters

- `user_id` string, required

## Response `204`

The user was successfully deleted. As per [RFC-7644 §3.6](https://datatracker.ietf.org/doc/html/rfc7644#section-3.6), no response body is returned.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized.
- `404`: The resource was not found.
- `429`: Rate limit exceeded.
- `500`: Server error.

---

[API](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api.md) - [All operations](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-workforce-api/revisions/562e14b2e4ba?raw)