---
title: "Delete a user"
description: "Use DELETE /users/{user} to delete a user by numeric ID. The operation documented here is User.delete."
canonical: https://docs.ordering.co/api-reference/guides/delete-user/
---

# Delete a user

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/api-reference/#tag/users/DELETE/users/{user})

Use `DELETE /users/{user}` to delete a user by numeric ID. The operation documented here is `User.delete`.

The final path parameter `user` identifies the user to delete by numeric ID.

The documented schema requires authentication. Non-administrators can delete only their own user account; administrators can delete other users but not their own account. Protected users and administrator accounts marked as protected in project settings cannot be deleted.

The operation may update unique identity fields before soft-deleting the user. Treat it as a destructive soft delete and confirm the target account before proceeding.

## Legacy SDK example

```javascript
const response = await ordering.users(userId).delete()
```

Confirm the SDK package and version before using this helper.

## OpenAPI reference

**Operation:** `DELETE /users/{user}`

**Path parameters**

| Name   | Type    | Required | Description |
| ------ | ------- | -------- | ----------- |
| `user` | integer | Yes      | —           |

**Header parameters**

| Name         | Type   | Required | Description |
| ------------ | ------ | -------- | ----------- |
| `User-Agent` | string | No       | —           |

**Responses**

| Code | Description                           |
| ---- | ------------------------------------- |
| 200  | OK (Envelope)                         |
| 400  | Bad Request (ErrorResponse)           |
| 401  | Unauthorized                          |
| 404  | Not Found                             |
| 429  | Too Many Requests (ErrorResponse)     |
| 500  | Internal Server Error (ErrorResponse) |
| 503  | Service Unavailable (ErrorResponse)   |

[Open this operation in the API reference](https://docs.ordering.co/api-reference/#tag/users/DELETE/users/{user})