Accounts

Close an account

Deactivate or permanently close an account.

The Close Account endpoint permanently deactivates an account and all associated resources. Once closed, the account cannot be reactivated, and access tokens linked to it will be invalidated.

Warning: This action is irreversible. All subscriptions, payments, and linked users under the account will be terminated.

Endpoint

DELETE /v1/account

Headers

Key	Value	Required
Authorization	Bearer <access_token>	Yes

Response

Successful Response (200 OK)

{
  "id": "acct_001",
  "status": "closed",
  "closed_at": "2025-09-18T20:18:00Z",
  "message": "The account has been permanently closed."
}

Field	Type	Description
id	string	Unique identifier of the closed account.
status	string	Always closed.
closed_at	string	ISO 8601 timestamp of account closure.
message	string	Confirmation message.

Error Response (401 / 403 / 409)

{
  "error": "active_subscriptions",
  "message": "Account cannot be closed while active subscriptions exist."
}

Error Code	Meaning
unauthorized	Missing or invalid token.
forbidden	The token does not have permission to close this account.
active_subscriptions	The account has active subscriptions and must cancel them first.

Example Usage

cURL

curl -X DELETE "https://api.example.com/v1/account" \
  -H "Authorization: Bearer your_access_token"

JavaScript (Fetch)

const response = await fetch("https://api.example.com/v1/account", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer your_access_token"
  }
});

const data = await response.json();
console.log(data.status); // closed

Closing an account will also revoke all issued API keys and remove access to dashboards. Always export your data before using this endpoint.

Update account info

List accounts

Need help? Contact Support

Join our Discord Community

Questions? Contact Sales

On this page

Title