Skip to main content
DELETE /api/v2/accounts/{customerId} Hard-deletes a child customer account. Only CHILD customers can be deleted, and the caller must be an ADMIN on the parent (or a Scope3 SuperAdmin). The request is refused if the child still has linked resources.

​
Request

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

​
Parameters

FieldInTypeRequiredNotes
customerIdpathstringYesCustomer ID of the child to delete

​
Response

204 No Content — the child account was deleted. The response body is empty.

​
Errors

  • 401 UNAUTHORIZED — missing or invalid bearer token.
  • 403 FORBIDDEN — caller is not an ADMIN on the parent.
  • 404 NOT_FOUND — the customer does not exist or is not a child of the caller’s organization.
  • 409 CONFLICT — the child still has linked resources and cannot be deleted.
See Errors for the full error contract.

Account tasks

All account operations

Create child account

Add a child customer

List customer accounts

Accounts you can access