Skip to content

All resources

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

NameTypeRequiredDescription
codestringnoCode is required when it has none.
confirmEmailstringnoConfirmEmail is the account's own email address, typed by the person.
passwordstringnoPassword 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