Skip to content
These docs describe Tradr v0.17.0. Running an older release? Check the release notes for what changed.

Request deletion of the signed-in user's own account.

POST
/api/users/me/deletion
curl --request POST \
--url https://api.tradr.cloud/api/users/me/deletion \
--header 'Content-Type: application/json' \
--data '{ "password": "example" }'

Authed and DESTRUCTIVE. Requires the account password (checked server-side). With no renewing subscription the account is deleted immediately and the session cookie is cleared; otherwise deletion is scheduled for when billing resolves and the response carries that instant. Rate limited to 5 requests per 15 minutes per user, tightening to 3 while the shared rate-limit store is unavailable.

Media typeapplication/json
object
password
required
string
>= 8 characters <= 72 characters
Examplegenerated
{
"password": "example"
}

AccountDeletionResult — { outcome: 'deleted' } (session cleared) or { outcome: 'scheduled', scheduledFor }.

Media typeapplication/json
object
outcome
string
Allowed values: deleted scheduled
scheduledFor
string format: date-time
Example
{
"outcome": "deleted"
}

VALIDATION_ERROR — the password is missing or outside 8-72 characters.

No valid session.

INVALID_PASSWORD — the password does not match.

LAST_ADMIN, SUBSCRIPTION_UNRESOLVED, or DELETION_IN_PROGRESS.

Rate limit exceeded (5 / 15 min per user).

STRIPE_CANCEL_FAILED — the subscription could not be updated; nothing was deleted.