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

# Delete or archive a user

`DELETE /users/{userId}`

Permanently deletes or archives a user by their unique identifier. The `type` query parameter controls whether the user is fully deleted (`DELETED`) or archived (`ARCHIVED`). Deleting a user removes their account, numbers, and all associated resources. Archiving a user disables their account but preserves their data for future reactivation.

**Permission:** No specific permission required. A valid API key is sufficient.

**Monitoring:** Not needed.

> **Warning — Destructive operation:** This route does not enforce any specific permission category. Any valid API key can delete or archive any user in the team. Exercise extreme caution when using this endpoint, especially in automated workflows. Consider restricting API key distribution accordingly.

## Path parameters

- `userId` integer, required

## Query parameters

- `type` 'DELETED' | 'ARCHIVED'

## Response `200`

Successful operation

## Other responses

- `400` — The provided user ID is invalid
- `401` — Authentication token is missing, invalid, or expired
- `404` — No user found with the specified ID
- `500` — Internal server error
- `502` — Service temporarily unavailable

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)