# Delete user

URL: /en/docs/api/v1/users/id/delete
Last Updated: 2026-07-30T21:15:30.439Z

## Description
No description available.

## Available Actions
- Execute DELETE request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### DELETE /api/v1/users/{id}

**Delete user**

Permanently delete a user account. Users cannot delete their own accounts. This action cannot be undone.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | Yes | User ID |

**Responses:**

- `200` - User deleted successfully
  - `success` (boolean)
  - `data` (object)
    - `id` (string): ID of the deleted user
- `400` - Bad Request - User ID is required
- `401` - Unauthorized
- `403` - Forbidden - cannot delete own account or insufficient permissions
  - `error` (string)
- `404` - User not found
- `409` - Conflict - user has related records and cannot be deleted
  - `error` (string)
  - `code` (string)

  Example (User has dependencies):
  
  ```json
  {
  "error": "User has related records and cannot be deleted.",
  "code": "has_dependencies"
}
  ```
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X DELETE "https://app.orbiqhq.com/api/v1/users/{id}" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```

