Skip to content
Beeper Developer Docs
Download Beeper
API Reference
Client

Focus Beeper Desktop app

focus(ClientFocusParams**kwargs) -> FocusResponse
POST/v1/focus

Focus Beeper Desktop and optionally open a specific chat, jump to a message, or pre-fill text and an image.

ParametersExpand Collapse
chat_id: Optional[str]

Optional Beeper chat ID (or local chat ID) to focus after opening the app. If omitted, only opens/focuses the app.

draft_attachment_path: Optional[str]

Optional local image path to populate in the message input field.

draft_text: Optional[str]

Optional plain text to populate in the message input field.

message_id: Optional[str]

Optional message ID. Jumps to that message in the chat when opening.

ReturnsExpand Collapse
class FocusResponse: …

Response indicating successful app focus action.

success: bool

Whether the app was successfully opened/focused.

Focus Beeper Desktop app

import os
from beeper_desktop_api import BeeperDesktop

client = BeeperDesktop(
    access_token=os.environ.get("BEEPER_ACCESS_TOKEN"),  # This is the default and can be omitted
)
response = client.focus()
print(response.success)
{
  "success": true
}
Returns Examples
{
  "success": true
}