Docs
Account, keys and webhooks ›

Erase account

DELETE/v1/me

Erase a closed account now, rather than 30 days after it was closed.

Requestcurl
  1. curl -X DELETE https://agental.io/v1/me \
  2. -H "Authorization: Bearer $AGENTAL_API_KEY"
Answer204 No Content

No body: the status says it was done.

The closed account is erased now rather than on its eraseAt: its sandboxes, snapshots, mail, templates, settings and sign-in, and everything that names the person.

Headers

Authorizationrequired
Bearer key
An API key that may make this call.

Returns

204 The closed account is erased now rather than on its eraseAt: its sandboxes, snapshots, mail, templates, settings and sign-in, and everything that names the person. Usage, payments and credit are kept under the account's id alone, for accounting. Requires X-Agental-Confirm-Delete equal to the account's email address. The session cookie is cleared.

Errors and other answers

400 confirm_delete_required. Nothing was erased.
403session_required an API key cannot do this. A person signed in can, from Settings in the console.
409account_not_closed close it first with POST /v1/me/close. Nothing was erased.

Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.