API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Bridges

Manage bridge-backed account types, connections, and login sessions

List available bridges

client.Bridges.List(ctx) (*BridgeListResponse, error)

GET/v1/bridges

Get bridge

client.Bridges.Get(ctx, bridgeID) (*BridgeGetResponse, error)

GET/v1/bridges/{bridgeID}

Get bridge capabilities

client.Bridges.GetCapabilities(ctx, bridgeID) (*ProvisioningCapabilities, error)

GET/v1/bridges/{bridgeID}/capabilities

ModelsExpand Collapse

type Bridge struct{…}

Available bridge that can connect or reconnect chat accounts.

ID string

Bridge ID. Use with bridge endpoints.

Accounts []Account

Connected accounts for this bridge. Uses the same Account schema as GET /v1/accounts.

AccountID string

Chat account added to Beeper. Use this to route account-scoped actions. Examples include matrix for Beeper/Matrix, discordgo for a cloud bridge, slackgo.TEAM-USER for workspace-scoped cloud bridges, and local-whatsapp_ba_… for local bridges.

Bridge AccountBridge

Bridge metadata for the account. Available in Beeper Desktop v4.2.785+.

ID string

Bridge identifier. Beeper Cloud accounts often use the network type (for example matrix or discordgo); on-device accounts use a local bridge ID (for example local-whatsapp). Available in Beeper Desktop v4.2.785+.

Provider AccountBridgeProvider

Where this account runs: on this device or in Beeper Cloud. Available in Beeper Desktop v4.2.785+.

One of the following:

const AccountBridgeProviderCloud AccountBridgeProvider = "cloud"

const AccountBridgeProviderSelfHosted AccountBridgeProvider = "self-hosted"

const AccountBridgeProviderLocal AccountBridgeProvider = "local"

const AccountBridgeProviderPlatformSDK AccountBridgeProvider = "platform-sdk"

Type string

Bridge type, such as matrix, discordgo, slackgo, whatsapp, telegram, or twitter. Available in Beeper Desktop v4.2.785+.

Status AccountStatus

Current connection status for this account.

One of the following:

const AccountStatusConnected AccountStatus = "connected"

const AccountStatusConnecting AccountStatus = "connecting"

const AccountStatusBackfilling AccountStatus = "backfilling"

const AccountStatusConnectionRequired AccountStatus = "connection_required"

const AccountStatusReconnectRequired AccountStatus = "reconnect_required"

const AccountStatusAttentionRequired AccountStatus = "attention_required"

const AccountStatusDisconnected AccountStatus = "disconnected"

const AccountStatusDisabled AccountStatus = "disabled"

User User

User the account belongs to.

ID string

Stable Beeper user ID. Use as the primary key when referencing a person.

CannotMessage boolOptional

True if Beeper cannot initiate messages to this user (e.g., blocked, network restriction, or no DM path). The user may still message you.

Email stringOptional

Email address if known. Not guaranteed verified.

FullName stringOptional

Display name as shown in clients (e.g., ‘Alice Example’). May include emojis.

ImgURL stringOptional

Avatar image URL if available. This may be a remote URL, media URL, data URL, or local file URL depending on the source. May be temporary or available only on this device; download promptly if durable access is needed.

IsSelf boolOptional

True if this user represents the authenticated account’s own identity.

PhoneNumber stringOptional

User’s phone number in E.164 format (e.g., ‘+14155552671’). Omit if unknown.

Username stringOptional

Human-readable handle if available (e.g., ‘@alice’). May be network-specific and not globally unique.

Capabilities map[string, any]Optional

Runtime chat/message capabilities for this connected account, when available.

LoginID stringOptional

Bridge login ID for this account, when known. One bridge login can contain multiple chat accounts.

Network stringOptional

Human-friendly network name for the account. Omitted when the network is unknown.

StatusText stringOptional

Human-friendly account status text.

ActiveAccountCount int64

Number of active accounts for this network on this device.

minimum0

DisplayName string

Human-friendly bridge name shown in Beeper.

Provider BridgeProvider

Where accounts for this bridge run: on this device or in Beeper Cloud.

One of the following:

const BridgeProviderCloud BridgeProvider = "cloud"

const BridgeProviderSelfHosted BridgeProvider = "self-hosted"

const BridgeProviderLocal BridgeProvider = "local"

const BridgeProviderPlatformSDK BridgeProvider = "platform-sdk"

Status BridgeStatus

Whether this bridge can currently be used to connect new accounts.

One of the following:

const BridgeStatusAvailable BridgeStatus = "available"

const BridgeStatusConnected BridgeStatus = "connected"

const BridgeStatusLimitReached BridgeStatus = "limit_reached"

const BridgeStatusTemporarilyUnavailable BridgeStatus = "temporarily_unavailable"

const BridgeStatusDisabled BridgeStatus = "disabled"

SupportsMultipleAccounts bool

Whether this bridge can have multiple active accounts for the same network.

Type string

Underlying bridge type, such as matrix, discordgo, slackgo, whatsapp, telegram, or twitter.

Network stringOptional

Network grouping used for account counts and limits.

StatusText stringOptional

Human-friendly status text matching Beeper account management language.

type CookieField struct{…}

ID string

Field ID to send back in the fields object.

Name stringOptional

Cookie, header, or local storage key to collect.

Type CookieFieldTypeOptional

Browser storage source for this value.

One of the following:

const CookieFieldTypeCookie CookieFieldType = "cookie"

const CookieFieldTypeHeader CookieFieldType = "header"

const CookieFieldTypeLocalStorage CookieFieldType = "local_storage"

type DisappearingTimerCapability struct{…}

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

type GroupFieldCapability struct{…}

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

type GroupTypeCapabilities struct{…}

Group creation capabilities for one group type.

TypeDescription string

Avatar GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Disappear GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Name GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Parent GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Participants GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Topic GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Username GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

type LoginFlow struct{…}

Connect or reconnect flow option for a bridge.

ID string

Flow ID to pass when creating a bridge login session.

Description stringOptional

Short explanation for when to use this flow, when provided.

Name stringOptional

Display name for the flow, when provided.

type LoginInputField struct{…}

ID string

Field ID to send back in the fields object.

InitialValue stringOptional

Initial field value, when provided by the network.

Label stringOptional

Field label to show to the user.

Optional boolOptional

True if the user can leave this field empty.

Placeholder stringOptional

Placeholder text to show when the field is empty.

Type stringOptional

Suggested input type, such as text, password, or email.

type LoginSession struct{…}

BridgeID string

Bridge ID.

LoginSessionID string

Temporary bridge login session ID.

Status LoginSessionStatus

One of the following:

const LoginSessionStatusWaitingForInput LoginSessionStatus = "waiting_for_input"

const LoginSessionStatusWaitingForCookies LoginSessionStatus = "waiting_for_cookies"

const LoginSessionStatusWaitingForDisplay LoginSessionStatus = "waiting_for_display"

const LoginSessionStatusComplete LoginSessionStatus = "complete"

const LoginSessionStatusCancelled LoginSessionStatus = "cancelled"

const LoginSessionStatusFailed LoginSessionStatus = "failed"

Account AccountOptional

A chat account added to Beeper.

AccountID string

Chat account added to Beeper. Use this to route account-scoped actions. Examples include matrix for Beeper/Matrix, discordgo for a cloud bridge, slackgo.TEAM-USER for workspace-scoped cloud bridges, and local-whatsapp_ba_… for local bridges.

Bridge AccountBridge

Bridge metadata for the account. Available in Beeper Desktop v4.2.785+.

ID string

Bridge identifier. Beeper Cloud accounts often use the network type (for example matrix or discordgo); on-device accounts use a local bridge ID (for example local-whatsapp). Available in Beeper Desktop v4.2.785+.

Provider AccountBridgeProvider

Where this account runs: on this device or in Beeper Cloud. Available in Beeper Desktop v4.2.785+.

One of the following:

const AccountBridgeProviderCloud AccountBridgeProvider = "cloud"

const AccountBridgeProviderSelfHosted AccountBridgeProvider = "self-hosted"

const AccountBridgeProviderLocal AccountBridgeProvider = "local"

const AccountBridgeProviderPlatformSDK AccountBridgeProvider = "platform-sdk"

Type string

Bridge type, such as matrix, discordgo, slackgo, whatsapp, telegram, or twitter. Available in Beeper Desktop v4.2.785+.

Status AccountStatus

Current connection status for this account.

One of the following:

const AccountStatusConnected AccountStatus = "connected"

const AccountStatusConnecting AccountStatus = "connecting"

const AccountStatusBackfilling AccountStatus = "backfilling"

const AccountStatusConnectionRequired AccountStatus = "connection_required"

const AccountStatusReconnectRequired AccountStatus = "reconnect_required"

const AccountStatusAttentionRequired AccountStatus = "attention_required"

const AccountStatusDisconnected AccountStatus = "disconnected"

const AccountStatusDisabled AccountStatus = "disabled"

User User

User the account belongs to.

ID string

Stable Beeper user ID. Use as the primary key when referencing a person.

CannotMessage boolOptional

True if Beeper cannot initiate messages to this user (e.g., blocked, network restriction, or no DM path). The user may still message you.

Email stringOptional

Email address if known. Not guaranteed verified.

FullName stringOptional

Display name as shown in clients (e.g., ‘Alice Example’). May include emojis.

ImgURL stringOptional

Avatar image URL if available. This may be a remote URL, media URL, data URL, or local file URL depending on the source. May be temporary or available only on this device; download promptly if durable access is needed.

IsSelf boolOptional

True if this user represents the authenticated account’s own identity.

PhoneNumber stringOptional

User’s phone number in E.164 format (e.g., ‘+14155552671’). Omit if unknown.

Username stringOptional

Human-readable handle if available (e.g., ‘@alice’). May be network-specific and not globally unique.

Capabilities map[string, any]Optional

Runtime chat/message capabilities for this connected account, when available.

LoginID stringOptional

Bridge login ID for this account, when known. One bridge login can contain multiple chat accounts.

Network stringOptional

Human-friendly network name for the account. Omitted when the network is unknown.

StatusText stringOptional

Human-friendly account status text.

AccountID stringOptional

Chat account ID for reconnect flows, when known.

CurrentStep LoginSessionCurrentStepUnionOptional

Step the client should show or complete next. Omitted when the session is complete, cancelled, or failed.

One of the following:

type LoginSessionCurrentStepUserInput struct{…}

Fields []LoginInputField

ID string

Field ID to send back in the fields object.

InitialValue stringOptional

Initial field value, when provided by the network.

Label stringOptional

Field label to show to the user.

Optional boolOptional

True if the user can leave this field empty.

Placeholder stringOptional

Placeholder text to show when the field is empty.

Type stringOptional

Suggested input type, such as text, password, or email.

StepID string

Type UserInput

Attachments []anyOptional

Instructions stringOptional

User-facing instructions for this step.

type LoginSessionCurrentStepCookies struct{…}

Fields []CookieField

ID string

Field ID to send back in the fields object.

Name stringOptional

Cookie, header, or local storage key to collect.

Type CookieFieldTypeOptional

Browser storage source for this value.

One of the following:

const CookieFieldTypeCookie CookieFieldType = "cookie"

const CookieFieldTypeHeader CookieFieldType = "header"

const CookieFieldTypeLocalStorage CookieFieldType = "local_storage"

StepID string

Type Cookies

URL string

URL to open for the user.

ExpectedFinalURLRegex stringOptional

Regular expression that identifies the final URL after sign-in.

ExtractJs stringOptional

Optional extraction script for browser-based sign-in helpers. Treat as an opaque helper value.

Instructions stringOptional

User-facing instructions for this browser step.

UserAgent stringOptional

Suggested user agent for the browser session.

type LoginSessionCurrentStepDisplayAndWait struct{…}

Display LoginSessionCurrentStepDisplayAndWaitDisplayUnion

One of the following:

type LoginSessionCurrentStepDisplayAndWaitDisplayQrCode struct{…}

Data string

Type Qr

type LoginSessionCurrentStepDisplayAndWaitDisplayEmoji struct{…}

ImageURL string

Type Emoji

type LoginSessionCurrentStepDisplayAndWaitDisplayEmpty struct{…}

Type Nothing

StepID string

Type DisplayAndWait

Instructions stringOptional

User-facing instructions for this step.

type LoginSessionCurrentStepComplete struct{…}

Type Complete

Account AccountOptional

A chat account added to Beeper.

AccountID string

Chat account added to Beeper. Use this to route account-scoped actions. Examples include matrix for Beeper/Matrix, discordgo for a cloud bridge, slackgo.TEAM-USER for workspace-scoped cloud bridges, and local-whatsapp_ba_… for local bridges.

Bridge AccountBridge

Bridge metadata for the account. Available in Beeper Desktop v4.2.785+.

ID string

Bridge identifier. Beeper Cloud accounts often use the network type (for example matrix or discordgo); on-device accounts use a local bridge ID (for example local-whatsapp). Available in Beeper Desktop v4.2.785+.

Provider AccountBridgeProvider

Where this account runs: on this device or in Beeper Cloud. Available in Beeper Desktop v4.2.785+.

One of the following:

const AccountBridgeProviderCloud AccountBridgeProvider = "cloud"

const AccountBridgeProviderSelfHosted AccountBridgeProvider = "self-hosted"

const AccountBridgeProviderLocal AccountBridgeProvider = "local"

const AccountBridgeProviderPlatformSDK AccountBridgeProvider = "platform-sdk"

Type string

Bridge type, such as matrix, discordgo, slackgo, whatsapp, telegram, or twitter. Available in Beeper Desktop v4.2.785+.

Status AccountStatus

Current connection status for this account.

One of the following:

const AccountStatusConnected AccountStatus = "connected"

const AccountStatusConnecting AccountStatus = "connecting"

const AccountStatusBackfilling AccountStatus = "backfilling"

const AccountStatusConnectionRequired AccountStatus = "connection_required"

const AccountStatusReconnectRequired AccountStatus = "reconnect_required"

const AccountStatusAttentionRequired AccountStatus = "attention_required"

const AccountStatusDisconnected AccountStatus = "disconnected"

const AccountStatusDisabled AccountStatus = "disabled"

User User

User the account belongs to.

ID string

Stable Beeper user ID. Use as the primary key when referencing a person.

CannotMessage boolOptional

True if Beeper cannot initiate messages to this user (e.g., blocked, network restriction, or no DM path). The user may still message you.

Email stringOptional

Email address if known. Not guaranteed verified.

FullName stringOptional

Display name as shown in clients (e.g., ‘Alice Example’). May include emojis.

ImgURL stringOptional

Avatar image URL if available. This may be a remote URL, media URL, data URL, or local file URL depending on the source. May be temporary or available only on this device; download promptly if durable access is needed.

IsSelf boolOptional

True if this user represents the authenticated account’s own identity.

PhoneNumber stringOptional

User’s phone number in E.164 format (e.g., ‘+14155552671’). Omit if unknown.

Username stringOptional

Human-readable handle if available (e.g., ‘@alice’). May be network-specific and not globally unique.

Capabilities map[string, any]Optional

Runtime chat/message capabilities for this connected account, when available.

LoginID stringOptional

Bridge login ID for this account, when known. One bridge login can contain multiple chat accounts.

Network stringOptional

Human-friendly network name for the account. Omitted when the network is unknown.

StatusText stringOptional

Human-friendly account status text.

Instructions stringOptional

Completion instructions, when provided.

Login LoginSessionCurrentStepCompleteLoginOptional

Signed-in identity for a bridge. One bridge login can contain multiple chat accounts.

BridgeID string

Bridge ID.

LoginID string

Bridge login ID.

RemoveScopes []string

One of the following:

const LoginSessionCurrentStepCompleteLoginRemoveScopeCurrentDevice LoginSessionCurrentStepCompleteLoginRemoveScope = "current-device"

const LoginSessionCurrentStepCompleteLoginRemoveScopeAllDevices LoginSessionCurrentStepCompleteLoginRemoveScope = "all-devices"

Status string

One of the following:

const LoginSessionCurrentStepCompleteLoginStatusConnected LoginSessionCurrentStepCompleteLoginStatus = "connected"

const LoginSessionCurrentStepCompleteLoginStatusConnecting LoginSessionCurrentStepCompleteLoginStatus = "connecting"

const LoginSessionCurrentStepCompleteLoginStatusNeedsLogin LoginSessionCurrentStepCompleteLoginStatus = "needs_login"

const LoginSessionCurrentStepCompleteLoginStatusLoggedOut LoginSessionCurrentStepCompleteLoginStatus = "logged_out"

const LoginSessionCurrentStepCompleteLoginStatusUnknown LoginSessionCurrentStepCompleteLoginStatus = "unknown"

AccountIDs []stringOptional

Chat accounts that belong to this bridge login, when known.

StatusText stringOptional

Human-friendly bridge login status text.

User UserOptional

User the account belongs to.

ID string

Stable Beeper user ID. Use as the primary key when referencing a person.

CannotMessage boolOptional

True if Beeper cannot initiate messages to this user (e.g., blocked, network restriction, or no DM path). The user may still message you.

Email stringOptional

Email address if known. Not guaranteed verified.

FullName stringOptional

Display name as shown in clients (e.g., ‘Alice Example’). May include emojis.

ImgURL stringOptional

Avatar image URL if available. This may be a remote URL, media URL, data URL, or local file URL depending on the source. May be temporary or available only on this device; download promptly if durable access is needed.

IsSelf boolOptional

True if this user represents the authenticated account’s own identity.

PhoneNumber stringOptional

User’s phone number in E.164 format (e.g., ‘+14155552671’). Omit if unknown.

Username stringOptional

Human-readable handle if available (e.g., ‘@alice’). May be network-specific and not globally unique.

StepID stringOptional

Error APIErrorOptional

Code string

Message string

Details map[string, any]Optional

Login LoginSessionLoginOptional

Signed-in identity for a bridge. One bridge login can contain multiple chat accounts.

BridgeID string

Bridge ID.

LoginID string

Bridge login ID.

RemoveScopes []string

One of the following:

const LoginSessionLoginRemoveScopeCurrentDevice LoginSessionLoginRemoveScope = "current-device"

const LoginSessionLoginRemoveScopeAllDevices LoginSessionLoginRemoveScope = "all-devices"

Status string

One of the following:

const LoginSessionLoginStatusConnected LoginSessionLoginStatus = "connected"

const LoginSessionLoginStatusConnecting LoginSessionLoginStatus = "connecting"

const LoginSessionLoginStatusNeedsLogin LoginSessionLoginStatus = "needs_login"

const LoginSessionLoginStatusLoggedOut LoginSessionLoginStatus = "logged_out"

const LoginSessionLoginStatusUnknown LoginSessionLoginStatus = "unknown"

AccountIDs []stringOptional

Chat accounts that belong to this bridge login, when known.

StatusText stringOptional

Human-friendly bridge login status text.

User UserOptional

User the account belongs to.

ID string

Stable Beeper user ID. Use as the primary key when referencing a person.

CannotMessage boolOptional

True if Beeper cannot initiate messages to this user (e.g., blocked, network restriction, or no DM path). The user may still message you.

Email stringOptional

Email address if known. Not guaranteed verified.

FullName stringOptional

Display name as shown in clients (e.g., ‘Alice Example’). May include emojis.

ImgURL stringOptional

Avatar image URL if available. This may be a remote URL, media URL, data URL, or local file URL depending on the source. May be temporary or available only on this device; download promptly if durable access is needed.

IsSelf boolOptional

True if this user represents the authenticated account’s own identity.

PhoneNumber stringOptional

User’s phone number in E.164 format (e.g., ‘+14155552671’). Omit if unknown.

Username stringOptional

Human-readable handle if available (e.g., ‘@alice’). May be network-specific and not globally unique.

LoginID stringOptional

Bridge login ID for reconnect flows, when known.

type ProvisioningCapabilities struct{…}

Advanced network capabilities for account lookup and group creation.

GroupCreation map[string, GroupTypeCapabilities]

TypeDescription string

Avatar GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Disappear GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Name GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Parent GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Participants GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Topic GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

Username GroupFieldCapabilityOptional

Group creation field capability.

Allowed bool

MaxLength int64Optional

MinLength int64Optional

Required boolOptional

Settings DisappearingTimerCapabilityOptional

Disappearing-message timer capability.

Types []string

One of the following:

const DisappearingTimerCapabilityTypeEmpty DisappearingTimerCapabilityType = ""

const DisappearingTimerCapabilityTypeAfterRead DisappearingTimerCapabilityType = "after_read"

const DisappearingTimerCapabilityTypeAfterSend DisappearingTimerCapabilityType = "after_send"

OmitEmptyTimer boolOptional

Timers []int64Optional

ResolveIdentifier ResolveIdentifierCapabilities

Identifier lookup capabilities for this bridge.

AnyPhone bool

ContactList bool

CreateDM bool

LookupEmail bool

LookupPhone bool

LookupUsername bool

Search bool

ImagePackImport boolOptional

type ResolveIdentifierCapabilities struct{…}

Identifier lookup capabilities for this bridge.

AnyPhone bool

ContactList bool

CreateDM bool

LookupEmail bool

LookupPhone bool

LookupUsername bool

Search bool

BridgesLogin Flows

Available bridges, bridge logins, login sessions for connect and reconnect flows, and advanced network capabilities.

List login flows

client.Bridges.LoginFlows.List(ctx, bridgeID) (*BridgeLoginFlowListResponse, error)

GET/v1/bridges/{bridgeID}/login-flows

BridgesConnections

BridgesLogin Sessions

Available bridges, bridge logins, login sessions for connect and reconnect flows, and advanced network capabilities.

Create bridge login session

client.Bridges.LoginSessions.New(ctx, bridgeID, body) (*LoginSession, error)

POST/v1/bridges/{bridgeID}/login-sessions

Get bridge login session

client.Bridges.LoginSessions.Get(ctx, loginSessionID, query) (*LoginSession, error)

GET/v1/bridges/{bridgeID}/login-sessions/{loginSessionID}

Cancel bridge login session

client.Bridges.LoginSessions.Cancel(ctx, loginSessionID, body) (*BridgeLoginSessionCancelResponse, error)

DELETE/v1/bridges/{bridgeID}/login-sessions/{loginSessionID}

BridgesLogin SessionsSteps

Available bridges, bridge logins, login sessions for connect and reconnect flows, and advanced network capabilities.

Submit login step

client.Bridges.LoginSessions.Steps.Submit(ctx, stepID, params) (*LoginSession, error)

POST/v1/bridges/{bridgeID}/login-sessions/{loginSessionID}/steps/{stepID}