Skip to main content
POST
/
:projectId
/
api
/
v7
/
auth
/
request-account-deletion
Request Account Deletion
curl --request POST \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/auth/request-account-deletion
{
  "success": true
}
Starts the self-service account-deletion flow for the authenticated user. The server generates a one-time, 6-digit confirmation code, emails it to the user’s registered address, and stores it for 10 minutes. The user completes deletion by passing that code to the Confirm Account Deletion endpoint. Requires a valid user access token. This step does not delete anything — it only sends the code.
This flow only works for accounts with an email on file. Accounts without one (e.g. anonymous or foreign-id users) cannot self-serve deletion — delete them server-side with a service key via the node SDK.

​
Body Parameters

This endpoint takes no body parameters.

​
Response

​
success
boolean
true when the request is processed without a server error. The response is intentionally generic.

​
Error Codes

CodeStatusDescription
auth/no-email-on-file400The authenticated account has no email address, so a confirmation code cannot be delivered. Use a service key to delete it instead.
Each call generates a fresh code and overwrites any pending one for that user. The code expires after 10 minutes.

​
See Also