account
4 endpoints
post /account/delete
Delete the caller's account
Requires authentication
Permanently deletes the account after the typed email confirmation and a re-authentication (the current password, or the emailed code for an account without one). Personal data is erased; content written in shared workspaces stays, attributed to "Deleted user". Every session ends at once. A wrong password or code is 403 REAUTH_FAILED (not 401, which clients read as an ended session). 409 ACCOUNT_DELETION_BLOCKED lists the organizations to deal with first. Irreversible.
Request body: dto.DeleteAccountRequest
| Name | Type | Required | Description |
|---|---|---|---|
| code | string | no | Code is required when it has none. |
| confirmEmail | string | no | ConfirmEmail is the account's own email address, typed by the person. |
| password | string | no | Password is required when the account has one. |
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
- 403 Forbidden · apimodel.ErrorEnvelope
- 409 Conflict · apimodel.ErrorEnvelope
- 429 Too Many Requests · apimodel.ErrorEnvelope
get /account/deletion-check
Check whether the account can be deleted
Requires authentication
Says how the caller confirms a deletion ("password" or an emailed "code") and lists the organizations that block it (sole owner of an organization that still has members, or the only member of one that holds billing or time-tracking records). Read-only.
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
- 403 Forbidden · apimodel.ErrorEnvelope
post /account/deletion-code
Email an account-deletion code
Requires authentication
For an account without a password: emails a 6-digit code to the account's address, valid 10 minutes. It confirms POST /account/delete and nothing else (a sign-in code cannot delete an account, and this one cannot sign in). An account with a password is refused with 400: it confirms with the password.
Responses
- 200 OK · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
- 403 Forbidden · apimodel.ErrorEnvelope
- 429 Too Many Requests · apimodel.ErrorEnvelope
get /account/export
Export the caller's personal data
Requires authentication
Returns the authenticated user's personal data as a downloadable JSON file (GDPR right to access / data portability). This endpoint streams a file attachment, not the standard success envelope.
Responses
- 200 OK · dto.UserDataExport
- 401 Unauthorized · apimodel.ErrorEnvelope