## Delete an address (tenant:masterdata:write)

`DELETE /api/masterdata/addresses/{id}`

Module: Master data · operationId: `deleteAddress` · Tag: Addresses · Auth: access token (`Authorization: Bearer <accessToken>`)

Soft-deletes the address and removes its distributor IDs. An address that is still the
supplier or manufacturer of an article answers `409`. An address whose `deletionBlockedUntil` has not passed (inclusive) answers `409` ("Löschsperre bis TT.MM.JJJJ"). Emits `masterdata.address.deleted`.
The personal data of a deleted address is removed once its grace period has passed (GDPR; 90 days by default,
not while `deletionBlockedUntil` has not passed): names, contact data, notes, tags, custom fields, contact persons,
postal addresses and bank accounts go – a bank account under a SEPA mandate stays without its holder until 14
months after the mandate's last use. Address number, customer and supplier number, a company's name and VAT ID and
the VAT ID check protocol stay. `masterdata.address.deleted` is emitted again with `anonymized: true`.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Responses

- **204** Deleted
- **401** Missing, invalid or expired token (empty body)
- **403** The token lacks the permission or carries no tenant (`application/json`)
- **404** Not found in the caller's tenant (or merged, see `code`) (`application/json`)
- **409** Stale version or conflict with existing data (`application/json`)

### Example request

```bash
curl -X DELETE 'https://api.mbcom.cloud/api/masterdata/addresses/3f6c1a52-7b1e-4d2a-9c8e-2b5f0d6a91e4' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
