Skip to navigation

Delete a customer unit alias by the unit's key

Deletes an alias of this unit, without naming its customer. Signals still sent with it then resolve to nothing again. The key is looked up across the organization ignoring letter case. When more than one unit carries it in another letter case (legacy duplicates across customers, or case variants on one customer), the exact spelling decides; when that does not single one out either, the answer is 409 CUSTOMER_UNIT_AMBIGUOUS: use the customer’s unit routes, where the key is exact.

Authentication

AuthorizationBearer
API Key authentication using Bearer token

Path parameters

externalCustomerUnitIdstringRequired>=1 character

Your id of the unit (its externalId), unique within the organization ignoring letter case.

aliasstringRequired>=1 character
The alias, as created.

Response

200

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error