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
curl -X DELETE 'https://api.mbcom.cloud/api/masterdata/addresses/3f6c1a52-7b1e-4d2a-9c8e-2b5f0d6a91e4' \
-H "Authorization: Bearer $ACCESS_TOKEN"