anon_email
API referenceAccount

Delete the account

DELETE
/account

Delete the caller's Cognito user and every item it owns: aliases, recipients, profile, and subscription. Irreversible.

No password is required: the caller's bearer token is forwarded to Cognito's DeleteUser. Note that DeleteUser requires an access token, while the authorizer authenticates with an ID token — see the Authentication guide.

Authorization

CognitoUserPool
headerAuthorizationBearer <token>

Cognito user pool ID token. API Gateway validates the token (identity token: no OAuth scopes are configured on the authorizer) and forwards its claims; the sub claim is the tenant key.

Response Body

Account and all its data deleted.

curl -X DELETE "https://example.com/account"
Empty