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.
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. |
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 | Bearer token for the new 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.
| Field | Type | Description |
|---|---|---|
cancelled | bool | True when a pending flow was removed or already absent. |