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

# Delete a user

`DELETE /v1/users/{userId}`

## Request

- Base URL: `https://api.telgea.com`
- URL: `https://api.telgea.com/v1/users/{userId}`
- Auth: API key in header `x-api-key`

Permanently deletes a user from your organization.

**Important Restrictions:**
- Cannot delete users with active phone numbers (must terminate user plan first)
- Cannot delete admin users
- Cannot delete yourself

Before deleting, ensure the user's local number is in SUSPENDED, DEACTIVATED state, or doesn't exist.

## Path parameters

- `userId` string, uuid, required: UUID of the user.

## Headers

- `idempotency-key` string: A value unique to this request, of 1 to 255 printable ASCII characters — a UUID is the usual choice. Retry with the same key within 24 hours and you get the original response back, even if it was a failure, and nothing is done twice. Send a new key whenever you change the request. Keys are private to your API key and organisation.

## Response `204`

User deleted successfully. No content returned.

## Other responses

- `400`: Cannot delete user with active phone numbers
- `401`: Missing or invalid API key in the X-API-Key header
- `403`: Insufficient permissions, or attempting to delete self or admin user
- `404`: User not found
- `429`: The API key has used its request quota for the current window. `Retry-After` says how many seconds until it resets.
- `500`: Internal server error. Contact support if this persists.

---

[API](https://skmtc.dev/telgea/apis/telgea-api.md) - [All operations](https://skmtc.dev/telgea/apis/telgea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/telgea/apis/telgea-api/revisions/4e8f8c04fe9e?raw)