ExternalIdentityAuthService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
ExternalIdentityAuthService
Section titled “ExternalIdentityAuthService”Public external identity authentication operations.
GetPendingExternalIdentity
Section titled “GetPendingExternalIdentity”Reads safe metadata for a pending create/link flow. This public RPC requires a valid pending-flow capability token and returns NOT_FOUND when the token is unknown or expired. Returns FAILED_PRECONDITION when a managed provider username cannot be assigned; the user must contact the operator.
POST /api/connect/chatto.auth.v1.ExternalIdentityAuthService/GetPendingExternalIdentityInput: GetPendingExternalIdentityRequest
Section titled “Input: GetPendingExternalIdentityRequest”Request to inspect a pending external identity flow.
| Field | Type | Description |
|---|---|---|
token | string | Raw pending flow token from the provider callback redirect. |
Result: GetPendingExternalIdentityResponse
Section titled “Result: GetPendingExternalIdentityResponse”Result of inspecting a pending external identity flow.
| Field | Type | Description |
|---|---|---|
pending | PendingExternalIdentity | Pending flow metadata. |
CreateExternalIdentityAccount
Section titled “CreateExternalIdentityAccount”Creates a passwordless account from a pending provider identity. This public RPC requires a valid create-flow capability token.
POST /api/connect/chatto.auth.v1.ExternalIdentityAuthService/CreateExternalIdentityAccountInput: CreateExternalIdentityAccountRequest
Section titled “Input: CreateExternalIdentityAccountRequest”Request to create a new passwordless account from a pending provider identity.
| Field | Type | Description |
|---|---|---|
token | string | Raw pending create token from the provider callback redirect. |
login | string | Desired username. Ignored when choose_username is externally managed; the server assigns a name from the verified provider claim in that case. Otherwise, it must contain 2 to 32 characters and use a valid username format. |
display_name | string | Desired display name. When omitted, the server uses a valid provider hint and otherwise falls back to the assigned username. |
invitation_code | string | Required on invite-only servers when the flow has no valid invitation. A supplied code replaces the flow’s invitation for this attempt; an invalid code fails without fallback. Consumed only when account creation succeeds. |
Result: CreateExternalIdentityAccountResponse
Section titled “Result: CreateExternalIdentityAccountResponse”Result of creating an account from a pending provider identity.
| Field | Type | Description |
|---|---|---|
user_id | string | Newly created user ID. |
login | string | Newly created username. |
token | string | Short-lived bearer access token for the new session. |
refresh_token | string | Rotating refresh credential for renewing the bearer session. |
expires_in | int64 | Lifetime of the access token in seconds. |
refresh_token_expires_in | int64 | Remaining lifetime of the current renewable-session window in seconds. A successful refresh can advance this window for an active session. |
ConfirmExternalIdentityLink
Section titled “ConfirmExternalIdentityLink”Links a provider identity using a pending link-flow capability token. This public RPC requires a valid link-flow capability token.
POST /api/connect/chatto.auth.v1.ExternalIdentityAuthService/ConfirmExternalIdentityLinkInput: ConfirmExternalIdentityLinkRequest
Section titled “Input: ConfirmExternalIdentityLinkRequest”Request to confirm a pending provider link using the flow capability token.
| Field | Type | Description |
|---|---|---|
token | string | Raw pending link token from the provider callback redirect. |
Result: ConfirmExternalIdentityLinkResponse
Section titled “Result: ConfirmExternalIdentityLinkResponse”Result of confirming a provider identity link.
| Field | Type | Description |
|---|---|---|
linked_identity | chatto.api.v1.LinkedExternalIdentity | Linked identity metadata. |
CancelExternalIdentityFlow
Section titled “CancelExternalIdentityFlow”Cancels a pending provider identity flow. This public RPC requires a valid pending-flow capability token.
POST /api/connect/chatto.auth.v1.ExternalIdentityAuthService/CancelExternalIdentityFlowInput: CancelExternalIdentityFlowRequest
Section titled “Input: CancelExternalIdentityFlowRequest”Request to cancel a pending external identity flow.
| Field | Type | Description |
|---|---|---|
token | string | Raw pending flow token. |
Result: CancelExternalIdentityFlowResponse
Section titled “Result: CancelExternalIdentityFlowResponse”Result of cancelling a pending external identity flow.