API Reference

Client

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Focus Beeper Desktop app

$ beeper-desktop focus

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 string

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 string

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

--draft-text: optional string

Optional plain text to populate in the message input field.

--message-id: optional string

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

ReturnsExpand Collapse

FocusResponse: object { success }

Response indicating successful app focus action.

success: boolean

Whether the app was successfully opened/focused.

Focus Beeper Desktop app

CLI Tool

HTTP

TypeScript

Python

Go

CLI Tool

PHP

beeper-desktop focus \
  --access-token 'My Access Token'

200 example

{
  "success": true
}

Returns Examples

200 example

{
  "success": true
}