> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /api/v1/customers/external/:external_id

> Remove um cliente pelo seu identificador externo (soft delete)

Realiza a exclusão lógica (soft delete) de um cliente identificado pelo `external_id`. O registro é marcado com a data de exclusão em `deleted_at` e o `external_id` é limpo. O cliente não aparece mais em listagens, mas os dados são preservados para histórico de vendas e transações.

## Autenticação

Requer **Organization Access Token (OAT)** via header `Authorization: Bearer`. Escopos necessários: `web:write` ou `customers:write`.

## Parâmetros de Caminho

**external\_id** `string` *required*

Identificador externo único do cliente dentro da organização, conforme definido na criação ou atualização.

## Resposta

Retorna `204 No Content` em caso de sucesso, sem corpo na resposta.

## Exemplo

```bash cURL theme={null}
curl -X DELETE "https://api.chargefy.io/api/v1/customers/external/user_001" \
  -H "Authorization: Bearer $CHARGEFY_ACCESS_TOKEN"
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

await chargefy.customers.deleteByExternalId('user_001');
```

## Resposta de Exemplo

```
HTTP/1.1 204 No Content
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.