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

​
Request

curl

​
Parameters

​
Response

204 No Content — the 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 organization.
  • 404 NOT_FOUND — the account does not exist or is not under the caller’s organization.
  • 409 CONFLICT — the account still has linked resources and cannot be deleted.
See Errors for the full error contract.

Account tasks

All account operations

Create account

Add an account under your organization

List accounts

Accounts you can access