v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

Customer Accounts (MTA)

Divest customer account

Divests an existing customer account

post/accounts/{zrn}/divest

Path parameters

zrnstring required

The ZRN of the customer account to divest. The ZRN must be in the format: zrn:zh:eu:account:customer:<uuid>

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required

Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Request body

DivestCustomerAccountBody required

Request body for divesting a customer account. Divesting an account initiates the process of liquidating the account's assets and closing the account. This is typically used when an account is being closed or transferred to another entity.

Response

Request to divest the customer account accepted. Divestment is applied asynchronously; clients should listen for the customer_account_status_changed webhook event to observe the new state.

object required

Empty JSON object.