api.md

Shared Types

from beeper_desktop_api.types import (
    APIError,
    AppStateSnapshot,
    Attachment,
    Error,
    Message,
    Reaction,
    User,
)

BeeperDesktop

Types:

from beeper_desktop_api.types import FocusResponse, SearchResponse

Methods:

• client.focus(**params) -> FocusResponse
• client.search(**params) -> SearchResponse

Accounts

Types:

from beeper_desktop_api.types import (
    Account,
    AccountBridge,
    AccountRetrieveResponse,
    AccountListResponse,
)

Methods:

• client.accounts.retrieve(account_id) -> AccountRetrieveResponse
• client.accounts.list() -> AccountListResponse

Contacts

Types:

from beeper_desktop_api.types.accounts import ContactSearchResponse

Methods:

• client.accounts.contacts.list(account_id, **params) -> SyncCursorSearch[User]
• client.accounts.contacts.search(account_id, **params) -> ContactSearchResponse

Bridges

Types:

from beeper_desktop_api.types import (
    Bridge,
    CookieField,
    DisappearingTimerCapability,
    GroupFieldCapability,
    GroupTypeCapabilities,
    LoginFlow,
    LoginInputField,
    LoginSession,
    ProvisioningCapabilities,
    ResolveIdentifierCapabilities,
    BridgeRetrieveResponse,
    BridgeListResponse,
)

Methods:

• client.bridges.retrieve(bridge_id) -> BridgeRetrieveResponse
• client.bridges.list() -> BridgeListResponse
• client.bridges.retrieve_capabilities(bridge_id) -> ProvisioningCapabilities

LoginFlows

Types:

from beeper_desktop_api.types.bridges import LoginFlowListResponse

Methods:

• client.bridges.login_flows.list(bridge_id) -> LoginFlowListResponse

LoginSessions

Types:

from beeper_desktop_api.types.bridges import LoginSessionCancelResponse

Methods:

• client.bridges.login_sessions.create(bridge_id, **params) -> LoginSession
• client.bridges.login_sessions.retrieve(login_session_id, *, bridge_id) -> LoginSession
• client.bridges.login_sessions.cancel(login_session_id, *, bridge_id) -> LoginSessionCancelResponse

Steps

Methods:

• client.bridges.login_sessions.steps.submit(step_id, *, bridge_id, login_session_id, **params) -> LoginSession

Chats

Types:

from beeper_desktop_api.types import Chat, ChatCreateResponse, ChatListResponse, ChatStartResponse

Methods:

• client.chats.create(**params) -> ChatCreateResponse
• client.chats.retrieve(chat_id, **params) -> Chat
• client.chats.update(chat_id, **params) -> Chat
• client.chats.list(**params) -> SyncCursorNoLimit[ChatListResponse]
• client.chats.archive(chat_id, **params) -> None
• client.chats.mark_read(chat_id, **params) -> Chat
• client.chats.mark_unread(chat_id, **params) -> Chat
• client.chats.notify_anyway(chat_id) -> Chat
• client.chats.search(**params) -> SyncCursorSearch[Chat]
• client.chats.start(**params) -> ChatStartResponse

Reminders

Methods:

• client.chats.reminders.create(chat_id, **params) -> None
• client.chats.reminders.delete(chat_id) -> None

Messages

Reactions

Types:

from beeper_desktop_api.types.chats.messages import ReactionDeleteResponse, ReactionAddResponse

Methods:

• client.chats.messages.reactions.delete(reaction_key, *, chat_id, message_id) -> ReactionDeleteResponse
• client.chats.messages.reactions.add(message_id, *, chat_id, **params) -> ReactionAddResponse

Messages

Types:

from beeper_desktop_api.types import MessageUpdateResponse, MessageSendResponse

Methods:

• client.messages.retrieve(message_id, *, chat_id) -> Message
• client.messages.update(message_id, *, chat_id, **params) -> MessageUpdateResponse
• client.messages.list(chat_id, **params) -> SyncCursorNoLimit[Message]
• client.messages.delete(message_id, *, chat_id, **params) -> None
• client.messages.search(**params) -> SyncCursorSearch[Message]
• client.messages.send(chat_id, **params) -> MessageSendResponse

Assets

Types:

from beeper_desktop_api.types import (
    AssetDownloadResponse,
    AssetUploadResponse,
    AssetUploadBase64Response,
)

Methods:

• client.assets.download(**params) -> AssetDownloadResponse
• client.assets.serve(**params) -> BinaryAPIResponse
• client.assets.upload(**params) -> AssetUploadResponse
• client.assets.upload_base64(**params) -> AssetUploadBase64Response

Info

Types:

from beeper_desktop_api.types import InfoRetrieveResponse

Methods:

• client.info.retrieve() -> InfoRetrieveResponse

App

Types:

from beeper_desktop_api.types import Verification, AppSessionResponse

Methods:

• client.app.session() -> AppSessionResponse

Login

Types:

from beeper_desktop_api.types.app import (
    LoginRegisterResponse,
    LoginResponseResponse,
    LoginStartResponse,
)

Methods:

• client.app.login.email(**params) -> None
• client.app.login.register(**params) -> LoginRegisterResponse
• client.app.login.response(**params) -> LoginResponseResponse
• client.app.login.start() -> LoginStartResponse

Verification

RecoveryKey

Types:

from beeper_desktop_api.types.app.login.verification import RecoveryKeyVerifyResponse

Methods:

• client.app.login.verification.recovery_key.verify(**params) -> RecoveryKeyVerifyResponse

Reset

Types:

from beeper_desktop_api.types.app.login.verification.recovery_key import (
    ResetCreateResponse,
    ResetConfirmResponse,
)

Methods:

• client.app.login.verification.recovery_key.reset.create(**params) -> ResetCreateResponse
• client.app.login.verification.recovery_key.reset.confirm(**params) -> ResetConfirmResponse

Verifications

Types:

from beeper_desktop_api.types.app import (
    VerificationCreateResponse,
    VerificationRetrieveResponse,
    VerificationListResponse,
    VerificationAcceptResponse,
    VerificationCancelResponse,
)

Methods:

• client.app.verifications.create(**params) -> VerificationCreateResponse
• client.app.verifications.retrieve(verification_id) -> VerificationRetrieveResponse
• client.app.verifications.list() -> VerificationListResponse
• client.app.verifications.accept(verification_id) -> VerificationAcceptResponse
• client.app.verifications.cancel(verification_id, **params) -> VerificationCancelResponse

Qr

Types:

from beeper_desktop_api.types.app.verifications import QrConfirmScannedResponse, QrScanResponse

Methods:

• client.app.verifications.qr.confirm_scanned(verification_id) -> QrConfirmScannedResponse
• client.app.verifications.qr.scan(**params) -> QrScanResponse

SAS

Types:

from beeper_desktop_api.types.app.verifications import SASConfirmResponse, SASStartResponse

Methods:

• client.app.verifications.sas.confirm(verification_id) -> SASConfirmResponse
• client.app.verifications.sas.start(verification_id) -> SASStartResponse