MyAccountService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
MyAccountService
Section titled “MyAccountService”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.
ChangePassword
Section titled “ChangePassword”Updates or adds the authenticated user’s password.
POST /api/connect/chatto.api.v1.MyAccountService/ChangePasswordInput: ChangePasswordRequest
Section titled “Input: ChangePasswordRequest”Request to update or add the authenticated user’s password.
| Field | Type | Description |
|---|---|---|
password | string | New password. The server applies the same password policy as registration and password reset. |
current_password | string | Current password. Required when the account already has a password; omitted when adding the first password to a passwordless account. |
Result: ChangePasswordResponse
Section titled “Result: ChangePasswordResponse”Result of updating or adding the authenticated account password.
| Field | Type | Description |
|---|---|---|
user | User | Current authenticated user profile after the password update. |
ListVerifiedEmails
Section titled “ListVerifiedEmails”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/ListVerifiedEmailsInput: ListVerifiedEmailsRequest
Section titled “Input: ListVerifiedEmailsRequest”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.
| Field | Type | Description |
|---|---|---|
expected_user_id | string | User ID that the client expects to be authenticated. |
Result: ListVerifiedEmailsResponse
Section titled “Result: ListVerifiedEmailsResponse”Verified email addresses for the authenticated user.
| Field | Type | Description |
|---|---|---|
verified_emails | repeated VerifiedEmail | No field description provided. |
RequestEmailVerification
Section titled “RequestEmailVerification”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/RequestEmailVerificationInput: RequestEmailVerificationRequest
Section titled “Input: RequestEmailVerificationRequest”Request a short-lived verification code for an email address.
| Field | Type | Description |
|---|---|---|
email | string | New address to verify and add to the authenticated user’s account. |
expected_user_id | string | User ID that the client expects to be authenticated. |
Result: RequestEmailVerificationResponse
Section titled “Result: RequestEmailVerificationResponse”Result of requesting an email verification code.
ConfirmEmailVerification
Section titled “ConfirmEmailVerification”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/ConfirmEmailVerificationInput: ConfirmEmailVerificationRequest
Section titled “Input: ConfirmEmailVerificationRequest”Confirm control of an email address with a verification code.
| Field | Type | Description |
|---|---|---|
email | string | Address that received the verification code. |
code | string | Six-digit code that the server sent to the address. |
expected_user_id | string | User ID that the client expects to be authenticated. |
Result: ConfirmEmailVerificationResponse
Section titled “Result: ConfirmEmailVerificationResponse”Verified email addresses after a successful confirmation.
| Field | Type | Description |
|---|---|---|
verified_emails | repeated VerifiedEmail | No field description provided. |
SetPrimaryEmail
Section titled “SetPrimaryEmail”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/SetPrimaryEmailInput: SetPrimaryEmailRequest
Section titled “Input: SetPrimaryEmailRequest”Select a verified email for account-directed email.
| Field | Type | Description |
|---|---|---|
email | string | Verified address to select as primary. |
expected_user_id | string | User ID that the client expects to be authenticated. |
Result: SetPrimaryEmailResponse
Section titled “Result: SetPrimaryEmailResponse”Verified email addresses after the primary address changes.
| Field | Type | Description |
|---|---|---|
verified_emails | repeated VerifiedEmail | No field description provided. |
GetSettings
Section titled “GetSettings”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/GetSettingsInput: GetSettingsRequest
Section titled “Input: GetSettingsRequest”Request the authenticated user’s display preferences. Human and bot accounts use the same operation; no target account ID is accepted.
Result: GetSettingsResponse
Section titled “Result: GetSettingsResponse”Current display preferences, with defaults for settings not yet saved.
| Field | Type | Description |
|---|---|---|
settings | UserSettings | The same settings resource returned by UpdateSettings and GetViewer. |
UpdateSettings
Section titled “UpdateSettings”Updates the authenticated user’s display preferences.
POST /api/connect/chatto.api.v1.MyAccountService/UpdateSettingsInput: UpdateSettingsRequest
Section titled “Input: UpdateSettingsRequest”Request to patch the authenticated user’s display preferences. update_mask selects fields to apply or reset. Resetting timezone clears the override.
| Field | Type | Description |
|---|---|---|
timezone | optional string | IANA timezone override. Empty clears the override. |
time_format | optional TimeFormat | Preferred time format. UNSPECIFIED restores the automatic format. |
share_timezone | optional bool | Whether the stored time zone may appear on the user’s public profile. |
update_mask | google.protobuf.FieldMask | Editable 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: UpdateSettingsResponse
Section titled “Result: UpdateSettingsResponse”Result of updating display preferences.
| Field | Type | Description |
|---|---|---|
settings | UserSettings | Stored settings after merging the request. |
ListExternalIdentities
Section titled “ListExternalIdentities”Lists configured external identity providers and identities linked to the authenticated account.
POST /api/connect/chatto.api.v1.MyAccountService/ListExternalIdentitiesInput: ListExternalIdentitiesRequest
Section titled “Input: ListExternalIdentitiesRequest”Request to list configured and linked external identities for the current user.
Result: ListExternalIdentitiesResponse
Section titled “Result: ListExternalIdentitiesResponse”Finite snapshot of configured providers and linked external identities.
| Field | Type | Description |
|---|---|---|
providers | repeated ExternalIdentityProvider | Configured providers the user may link. |
linked_identities | repeated LinkedExternalIdentity | Provider identities already linked to the authenticated user. |
StartExternalIdentityLink
Section titled “StartExternalIdentityLink”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/StartExternalIdentityLinkInput: StartExternalIdentityLinkRequest
Section titled “Input: StartExternalIdentityLinkRequest”Request to start linking a configured provider to the current user.
| Field | Type | Description |
|---|---|---|
provider_id | string | Provider ID to link. |
redirect_path | string | Internal path to return to after confirmation. |
current_password | string | Current password proof for accounts with a password when the active runtime credential is no longer fresh. |
Result: StartExternalIdentityLinkResponse
Section titled “Result: StartExternalIdentityLinkResponse”Result of preparing an external identity link flow.
| Field | Type | Description |
|---|---|---|
start_url | string | Browser URL that starts provider authorization on the target server origin. |
DisconnectExternalIdentity
Section titled “DisconnectExternalIdentity”Disconnects a provider identity from the authenticated account.
POST /api/connect/chatto.api.v1.MyAccountService/DisconnectExternalIdentityInput: DisconnectExternalIdentityRequest
Section titled “Input: DisconnectExternalIdentityRequest”Request to disconnect a linked provider identity from the authenticated user.
| Field | Type | Description |
|---|---|---|
subject_hash | string | Stable one-way subject hash of the linked identity to disconnect. |
current_password | string | Current 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.
SetPresence
Section titled “SetPresence”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/SetPresenceInput: SetPresenceRequest
Section titled “Input: SetPresenceRequest”Legacy live report. A saved private choice takes precedence over this report.
| Field | Type | Description |
|---|---|---|
status | PresenceStatus | Live status to store for the authenticated user. Offline is rejected. |
user_selected | bool | Legacy manual-selection flag. It cannot replace a saved private choice. New clients use SetPresencePreference for explicit selections. |
Result: SetPresenceResponse
Section titled “Result: SetPresenceResponse”Result of updating live presence.
| Field | Type | Description |
|---|---|---|
status | PresenceStatus | Reportable status accepted and stored by the server. |
GetPresencePreference
Section titled “GetPresencePreference”Reads the authenticated account’s private saved availability choice.
POST /api/connect/chatto.api.v1.MyAccountService/GetPresencePreferenceInput: GetPresencePreferenceRequest
Section titled “Input: GetPresencePreferenceRequest”Read the authenticated account’s own choice; accepts no other user ID.
Result: GetPresencePreferenceResponse
Section titled “Result: GetPresencePreferenceResponse”Current private choice, or absence before first initialization.
| Field | Type | Description |
|---|---|---|
preference | PresencePreference | Absent until the account first saves a choice. |
SetPresencePreference
Section titled “SetPresencePreference”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/SetPresencePreferenceInput: SetPresencePreferenceRequest
Section titled “Input: SetPresencePreferenceRequest”An explicit selection. Heartbeats must not call this operation.
| Field | Type | Description |
|---|---|---|
status | PresenceStatus | Explicit new choice for every device on this server. |
expected_revision | string | Revision from the last read; empty only when initializing an absent choice. |
Result: SetPresencePreferenceResponse
Section titled “Result: SetPresencePreferenceResponse”Acknowledged current choice after the selection commits.
| Field | Type | Description |
|---|---|---|
preference | PresencePreference | No field description provided. |
RefreshPresence
Section titled “RefreshPresence”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/RefreshPresenceInput: RefreshPresenceRequest
Section titled “Input: RefreshPresenceRequest”Refresh the authenticated account’s liveness without supplying a choice.
Result: RefreshPresenceResponse
Section titled “Result: RefreshPresenceResponse”Current private choice after refreshing liveness.
| Field | Type | Description |
|---|---|---|
preference | PresencePreference | Private saved choice; clients use this to recover missed device updates. |
SetCustomStatus
Section titled “SetCustomStatus”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/SetCustomStatusInput: SetCustomStatusRequest
Section titled “Input: SetCustomStatusRequest”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.
| Field | Type | Description |
|---|---|---|
emoji | string | Short emoji marker displayed with the status. |
text | string | User-written status text. |
expires_at | google.protobuf.Timestamp | Optional future time after which clients should stop showing the status. |
Result: SetCustomStatusResponse
Section titled “Result: SetCustomStatusResponse”Result of setting the current user’s complete custom status.
| Field | Type | Description |
|---|---|---|
status | CustomUserStatus | Stored custom status after validation and normalization. |
DeleteCustomStatus
Section titled “DeleteCustomStatus”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/DeleteCustomStatusInput: DeleteCustomStatusRequest
Section titled “Input: DeleteCustomStatusRequest”Request to delete the current user’s custom status.
Result: DeleteCustomStatusResponse
Section titled “Result: DeleteCustomStatusResponse”Result of deleting the current user’s custom status.
| Field | Type | Description |
|---|---|---|
status | CustomUserStatus | Current custom status after the operation. Usually absent after a clear. |
RequestAccountDeletion
Section titled “RequestAccountDeletion”Issues a short-lived token used to confirm self-deletion. Requires user.delete-self.
POST /api/connect/chatto.api.v1.MyAccountService/RequestAccountDeletionInput: RequestAccountDeletionRequest
Section titled “Input: RequestAccountDeletionRequest”Request a short-lived confirmation token for deleting the authenticated account.
Result: RequestAccountDeletionResponse
Section titled “Result: RequestAccountDeletionResponse”Result of issuing an account deletion confirmation token.
| Field | Type | Description |
|---|---|---|
confirmation_token | string | Confirmation token. Clients must pass this to DeleteMyAccount. |
DeleteMyAccount
Section titled “DeleteMyAccount”Permanently deletes the authenticated account after token validation. Requires user.delete-self.
POST /api/connect/chatto.api.v1.MyAccountService/DeleteMyAccountInput: DeleteMyAccountRequest
Section titled “Input: DeleteMyAccountRequest”Request to permanently delete the authenticated account.
| Field | Type | Description |
|---|---|---|
confirmation_token | string | Confirmation token obtained from RequestAccountDeletion. |
Result: DeleteMyAccountResponse
Section titled “Result: DeleteMyAccountResponse”Result of deleting the authenticated account.