---
title: "Delete a user"
method: DELETE
path: "/users/{userId}"
tags: ["users"]
---

# Delete a user

`DELETE /users/{userId}`

## Path parameters

- `userId` string, required

## Response `200`

Returns the deleted user.

- UserOutput
  - `data` object, required
    - `email` string, required — The email address of the user, this must be unique.
    - `password` string — The password of the user if using password based login - this will never be returned. This can be left out of subsequent requests (updates) and will be enriched back into the user structure.
    - `status` 'active' — The status of the user, if they are active.
    - `firstName` string — The first name of the user
    - `lastName` string — The last name of the user
    - `forceResetPassword` boolean — If set to true forces the user to reset their password on first login.
    - `_id` string, required — The ID of the user.

## Changes

- **2023-08-04** `9f4851dfc828` — 1 breaking, 2 warning
  - removed the required property `data/roles` from the response with the `200` status
  - removed the optional property `data/admin` from the response with the `200` status
  - removed the optional property `data/builder` from the response with the `200` status
- **2023-03-06** `7de0ab0187e0` — 1 info
  - the response property `data/roles` became required for the status `200`

[Change history](https://skmtc.dev/budibase/apis/budibase-api/changes/users/:userId/delete.md)

---

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