Delete child account - Interchange API

DELETE /api/v2/accounts/{customerId} Permanently deletes a child customer account. Only CHILD customers can be deleted, and the caller must be an ADMIN on the parent. The call refuses with 409 if the child still has linked resources — unwind those first.

Request

curl

curl -X DELETE https://api.interchange.io/api/v2/accounts/200 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`customerId`	string	Yes	Path parameter. ID of the child customer to delete

Response

204 No Content. The child account is removed; there is no response body.

Errors

401 UNAUTHORIZED — caller is not an ADMIN on the parent.
409 CONFLICT — the child still has linked resources.

See Errors for the full error contract.

Account tasks

All account operations

Create child account

Provision a new child

List customer accounts

Find the customer ID

Create child account Get current account

⌘I

​Request

​Parameters

​Response

​Errors

​Related