Skip to content
Beeper Developer Docs
Download Beeper
API Reference
Client

Focus Beeper Desktop app

POST/v1/focus

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

Body ParametersJSONExpand Collapse
chatID: optional string

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

draftAttachmentPath: optional string

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

draftText: optional string

Optional plain text to populate in the message input field.

messageID: optional string

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

ReturnsExpand Collapse
success: boolean

Whether the app was successfully opened/focused.

Focus Beeper Desktop app

curl http://localhost:23373/v1/focus \
    -X POST \
    -H "Authorization: Bearer $BEEPER_ACCESS_TOKEN"
{
  "success": true
}
Returns Examples
{
  "success": true
}