# Unlink a customer account

One call of the distributor API, read from the interface description Yutai publishes. Every sample answer on this page is simulated: no real holder's data stands behind it. The formats every value travels in are the [identifiers page](https://docs.yutai.com/identifiers)'s.

## The call

DELETE `/v1/connect/links/{external_ref}` Callable today

The key presents the `connect.write` scope.

The get started page shows [how a platform gets a key](https://docs.yutai.com/get-started#key-heading).

## The parameters

`external_ref`: Required. Your own opaque id for the person, the one the session was created with. It sits in the call's address.

## What it answers

The person's link is ended for the calling distributor. No body is answered.

## The errors

Every refused call answers one object with three fields: message, the plain sentence that says what did not happen; code, the closed refusal code the call log records beside the call; and requestId, the id to quote when asking Yutai about the call. The message carries 1 to 512 characters, the code 1 to 64 characters, and the request id 1 to 64 characters. Every answer carries the same id on its X-Request-Id header.

| Status | What it answers |
| --- | --- |
| 401 | The key is missing, malformed, unknown, revoked or expired. |
| 403 | The key does not carry the scope. The call is also refused with 403, nothing read, when the distributor is paused, suspended or closed, when the key is paused, or when the key presents from an origin it does not allow. |
| 404 | No standing link answers this reference under this distributor's key. Nothing was read. |
| 429 | The key made too many calls this minute. The Retry-After header names the seconds until the next window opens. Nothing was read. |
| 500 | The person's link was not ended, so the person stays linked. Nothing was changed. |

The errors and limits page carries [every refusal status the document declares](https://docs.yutai.com/errors#statuses-heading), each in its own words, beside the calls that answer it.