Skip to content
Chatto v0.5.0

MyAccountService

Chatto exposes this service below /api/connect.

Shared message and enum definitions are documented in Shared Types And Enums.

Self-service account, display preference, presence, custom-status, external identity, and account lifecycle commands for the authenticated user. Public profile and avatar changes use UserService.

Updates or adds the authenticated user’s password.

POST /api/connect/chatto.api.v1.MyAccountService/ChangePassword

Request to update or add the authenticated user’s password.

FieldTypeDescription
passwordstringNew password. The server applies the same password policy as registration and password reset.
current_passwordstringCurrent password. Required when the account already has a password; omitted when adding the first password to a passwordless account.

Result of updating or adding the authenticated account password.

FieldTypeDescription
userUserCurrent authenticated user profile after the password update.

Lists the authenticated user’s verified email addresses and primary choice. Returns FAILED_PRECONDITION when the authenticated account does not match expected_user_id.

POST /api/connect/chatto.api.v1.MyAccountService/ListVerifiedEmails

Request the authenticated user’s verified email addresses. expected_user_id binds the request to the account state that the client currently displays. The server returns FAILED_PRECONDITION if the authenticated account changed.

FieldTypeDescription
expected_user_idstringUser ID that the client expects to be authenticated.

Verified email addresses for the authenticated user.

FieldTypeDescription
verified_emailsrepeated VerifiedEmailNo field description provided.

Sends a six-digit code to an email address that the authenticated user wants to add. The code expires after the server-configured email OTP lifetime. The client can request a new code after expiry. The server must have transactional email enabled. Returns ALREADY_EXISTS when the address is already verified for the user, RESOURCE_EXHAUSTED after too many code requests or attempts, and UNAVAILABLE when email delivery is disabled or fails. Returns FAILED_PRECONDITION when the authenticated account does not match expected_user_id.

POST /api/connect/chatto.api.v1.MyAccountService/RequestEmailVerification

Request a short-lived verification code for an email address.

FieldTypeDescription
emailstringNew address to verify and add to the authenticated user’s account.
expected_user_idstringUser ID that the client expects to be authenticated.

Result of requesting an email verification code.

Confirms a verification code and adds the address to the account. Returns INVALID_ARGUMENT when the code is invalid or expired, and ALREADY_EXISTS when another user already controls the address. Returns FAILED_PRECONDITION when the authenticated account does not match expected_user_id.

POST /api/connect/chatto.api.v1.MyAccountService/ConfirmEmailVerification

Confirm control of an email address with a verification code.

FieldTypeDescription
emailstringAddress that received the verification code.
codestringSix-digit code that the server sent to the address.
expected_user_idstringUser ID that the client expects to be authenticated.

Verified email addresses after a successful confirmation.

FieldTypeDescription
verified_emailsrepeated VerifiedEmailNo field description provided.

Selects one verified address for future account-directed email. Returns NOT_FOUND when the address is not verified for the authenticated user, and FAILED_PRECONDITION when the authenticated account does not match expected_user_id.

POST /api/connect/chatto.api.v1.MyAccountService/SetPrimaryEmail

Select a verified email for account-directed email.

FieldTypeDescription
emailstringVerified address to select as primary.
expected_user_idstringUser ID that the client expects to be authenticated.

Verified email addresses after the primary address changes.

FieldTypeDescription
verified_emailsrepeated VerifiedEmailNo field description provided.

Reads the authenticated user’s display preferences without changing them. Returns default settings when none have been saved.

POST /api/connect/chatto.api.v1.MyAccountService/GetSettings

Request the authenticated user’s display preferences. Human and bot accounts use the same operation; no target account ID is accepted.

Current display preferences, with defaults for settings not yet saved.

FieldTypeDescription
settingsUserSettingsThe same settings resource returned by UpdateSettings and GetViewer.

Updates the authenticated user’s display preferences.

POST /api/connect/chatto.api.v1.MyAccountService/UpdateSettings

Request to patch the authenticated user’s display preferences. update_mask selects fields to apply or reset. Resetting timezone clears the override.

FieldTypeDescription
timezoneoptional stringIANA timezone override. Empty clears the override.
time_formatoptional TimeFormatPreferred time format. UNSPECIFIED restores the automatic format.
share_timezoneoptional boolWhether the stored time zone may appear on the user’s public profile.
update_maskgoogle.protobuf.FieldMaskEditable fields to apply or reset: timezone, time_format, share_timezone. Omit to infer populated fields; * selects all editable fields. An explicit empty mask is invalid. Unselected values are ignored. Selected absent values reset the field to its default, subject to field validation.

Result of updating display preferences.

FieldTypeDescription
settingsUserSettingsStored settings after merging the request.

Lists configured external identity providers and identities linked to the authenticated account.

POST /api/connect/chatto.api.v1.MyAccountService/ListExternalIdentities

Request to list configured and linked external identities for the current user.

Finite snapshot of configured providers and linked external identities.

FieldTypeDescription
providersrepeated ExternalIdentityProviderConfigured providers the user may link.
linked_identitiesrepeated LinkedExternalIdentityProvider identities already linked to the authenticated user.

Creates a short-lived browser handoff URL for linking a provider identity to the authenticated account. The provider callback completes through chatto.auth.v1.ExternalIdentityAuthService.ConfirmExternalIdentityLink.

POST /api/connect/chatto.api.v1.MyAccountService/StartExternalIdentityLink

Request to start linking a configured provider to the current user.

FieldTypeDescription
provider_idstringProvider ID to link.
redirect_pathstringInternal path to return to after confirmation.
current_passwordstringCurrent password proof for accounts with a password when the active runtime credential is no longer fresh.

Result of preparing an external identity link flow.

FieldTypeDescription
start_urlstringBrowser URL that starts provider authorization on the target server origin.

Disconnects a provider identity from the authenticated account.

POST /api/connect/chatto.api.v1.MyAccountService/DisconnectExternalIdentity

Request to disconnect a linked provider identity from the authenticated user.

FieldTypeDescription
subject_hashstringStable one-way subject hash of the linked identity to disconnect.
current_passwordstringCurrent password proof for accounts with a password when the active runtime credential is no longer fresh.

Result: DisconnectExternalIdentityResponse

Section titled “Result: DisconnectExternalIdentityResponse”

Result of disconnecting a provider identity.

Legacy live presence report, expiring after 60 seconds without refresh. A saved private choice overrides this report, including user_selected. New clients use SetPresencePreference for choices and RefreshPresence every 30 seconds for liveness.

POST /api/connect/chatto.api.v1.MyAccountService/SetPresence

Legacy live report. A saved private choice takes precedence over this report.

FieldTypeDescription
statusPresenceStatusLive status to store for the authenticated user. Offline is rejected.
user_selectedboolLegacy manual-selection flag. It cannot replace a saved private choice. New clients use SetPresencePreference for explicit selections.

Result of updating live presence.

FieldTypeDescription
statusPresenceStatusReportable status accepted and stored by the server.

Reads the authenticated account’s private saved availability choice.

POST /api/connect/chatto.api.v1.MyAccountService/GetPresencePreference

Read the authenticated account’s own choice; accepts no other user ID.

Current private choice, or absence before first initialization.

FieldTypeDescription
preferencePresencePreferenceAbsent until the account first saves a choice.

Saves a choice for all devices on this server. A stale revision returns ABORTED. OFFLINE suppresses public presence and typing; the choice survives disconnects.

POST /api/connect/chatto.api.v1.MyAccountService/SetPresencePreference

An explicit selection. Heartbeats must not call this operation.

FieldTypeDescription
statusPresenceStatusExplicit new choice for every device on this server.
expected_revisionstringRevision from the last read; empty only when initializing an absent choice.

Acknowledged current choice after the selection commits.

FieldTypeDescription
preferencePresencePreferenceNo field description provided.

Refreshes connection liveness without changing the saved choice. Clients call every 30 seconds; liveness expires after 60 seconds without a refresh. Accounts with a saved OFFLINE choice may refresh without public presence signals.

POST /api/connect/chatto.api.v1.MyAccountService/RefreshPresence

Refresh the authenticated account’s liveness without supplying a choice.

Current private choice after refreshing liveness.

FieldTypeDescription
preferencePresencePreferencePrivate saved choice; clients use this to recover missed device updates.

Sets the current user’s complete custom status. Emoji and text are required. Omit expires_at for no expiry, or supply a future time.

POST /api/connect/chatto.api.v1.MyAccountService/SetCustomStatus

Request to replace the current user’s complete custom status. Emoji and text are required. Omitted expires_at removes any previous expiry. Use DeleteCustomStatus to clear the status.

FieldTypeDescription
emojistringShort emoji marker displayed with the status.
textstringUser-written status text.
expires_atgoogle.protobuf.TimestampOptional future time after which clients should stop showing the status.

Result of setting the current user’s complete custom status.

FieldTypeDescription
statusCustomUserStatusStored custom status after validation and normalization.

Deletes the current user’s custom status. The call is idempotent and returns the resulting empty status state.

POST /api/connect/chatto.api.v1.MyAccountService/DeleteCustomStatus

Request to delete the current user’s custom status.

Result of deleting the current user’s custom status.

FieldTypeDescription
statusCustomUserStatusCurrent custom status after the operation. Usually absent after a clear.

Issues a short-lived token used to confirm self-deletion. Requires user.delete-self.

POST /api/connect/chatto.api.v1.MyAccountService/RequestAccountDeletion

Request a short-lived confirmation token for deleting the authenticated account.

Result of issuing an account deletion confirmation token.

FieldTypeDescription
confirmation_tokenstringConfirmation token. Clients must pass this to DeleteMyAccount.

Permanently deletes the authenticated account after token validation. Requires user.delete-self.

POST /api/connect/chatto.api.v1.MyAccountService/DeleteMyAccount

Request to permanently delete the authenticated account.

FieldTypeDescription
confirmation_tokenstringConfirmation token obtained from RequestAccountDeletion.

Result of deleting the authenticated account.