---
search:
  tags:
    - Merchant Users
    - DELETE
seo:
  description: >-
    Removes a merchant user from the system.… Reference for the DELETE
    /api/v1/{team_slug}/{app_slug}/merchant-users/{user_id} endpoint in the
    Management API.
sidebar:
  label: Delete merchant user
  badge: DELETE
title: Delete merchant user
type: openapi-operation
---
Removes a merchant user from the system. Supports both soft delete (default) and hard delete options

`DELETE /api/v1/{team_slug}/{app_slug}/merchant-users/{user_id}`

**Request body** (`application/json`, required)

Delete merchant user payload

- `hard_delete` (boolean)

Request body example:

```json
{
  "hard_delete": true
}
```

**Responses**

- `200` — User deleted successfully
- `400` — Invalid request (e.g. bad user ID format)
- `401` — Unauthorized access
- `404` — User not found
- `500` — Internal server error

Response example, 200:

```json
{
  "data": "string",
  "details": [
    "string"
  ],
  "success": true
}
```