---
title: "Schedule or immediately execute account deletion (self-service)."
method: POST
path: "/auth/unregister"
tags: ["Auth"]
---

# Schedule or immediately execute account deletion (self-service).

`POST /auth/unregister`

Marks the authenticated customer's account for deletion. The account enters 'frozen' state immediately.
Active calls are terminated and new operations are blocked.

By default, the customer has 30 days to recover via `DELETE /auth/unregister` before permanent deletion.

If `immediate` is set to `true`, the account is frozen and then permanently deleted (PII anonymized,
all resources cascade-deleted) in a single request. This cannot be undone.

Exactly one of `password` or `confirmation_phrase` must be provided:
- Password-based accounts: provide `password` for re-authentication.
- SSO or API-key authenticated requests: provide `confirmation_phrase` set to `"DELETE"`.

## Query parameters

- `accesskey` string

## Request body

- RequestBodyAuthUnregisterPOST — Request body for POST /auth/unregister (self-service account deletion). Exactly one of `password` or `confirmation_phrase` must be provided.
  - `password` string — Account password for re-authentication. Required for password-based accounts. Mutually exclusive with `confirmation_phrase`.
  - `confirmation_phrase` string — Must be exactly "DELETE". Required for SSO users and API-key authenticated requests. Mutually exclusive with `password`.
  - `immediate` boolean — If true, skip the 30-day grace period and delete the account immediately. The account is frozen and then permanently deleted (PII anonymized, all resources cascade-deleted) in a single request. Default: false.

## Response `200`

Account frozen successfully (or deleted if `immediate` was `true`).

- CustomerManagerCustomer
  - `id` string, uuid — The unique identifier of the customer.
  - `name` string — Name of the customer.
  - `detail` string — Details about the customer.
  - `email` string, email — Email address of the customer.
  - `phone_number` string — Customer's contact phone number in E.164 format.
  - `address` string — Address of the customer.
  - `webhook_method` '' | 'POST' | 'GET' | 'PUT' | 'DELETE' — The HTTP method used for webhook (e.g., POST, GET, PUT, DELETE).
  - `webhook_uri` string — URI where webhook events are delivered.
  - `billing_account_id` string, uuid — The unique identifier of the customer's default billing account. Returned from the `GET /billing_accounts/{id}` response.
  - `metadata` CustomerManagerMetadata — Configuration flags for a customer account. Controls platform behavior such as RTP packet capture for debugging audio issues. Updatable by CustomerAdmin via `PUT /customer/metadata` or by ProjectSuperAdmin via `PUT /customers/{id}/metadata`.
    - `rtp_debug` boolean — When set to `true`, RTPEngine captures RTP traffic as PCAP files for this customer's calls. Use this to debug audio quality issues (one-way audio, codec problems, jitter). Default is `false`. Enabling this increases storage usage — disable after debugging.
  - `email_verified` boolean — Whether the customer's email has been verified.
  - `status` 'initial' | 'active' | 'frozen' | 'deleted' | 'expired' — Account lifecycle status.
  - `identity_verification_status` 'none' | 'pending' | 'verified' | 'rejected' — Customer's identity verification status. Determines access to PSTN number purchases and outbound PSTN calls.
  - `tm_deletion_scheduled` string, date-time — Timestamp when account deletion was requested. Null if not scheduled.
  - `tm_create` string, date-time — Timestamp when the customer was created.
  - `tm_update` string, date-time — Timestamp when the customer was last updated.
  - `tm_delete` string, date-time — Timestamp when the customer was deleted.

## Other responses

- `400` — Bad request. Possible causes: - Neither `password` nor `confirmation_phrase` was provided. - Both `password` and `confirmation_phrase` were provided (exactly one required). - Password validation failed. - `confirmation_phrase` is not `"DELETE"`.
- `401` — Authentication failed. Invalid or missing access key / bearer token.

---

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