---
title: Open Beeper Desktop app - Beeper Developer Docs
---

Deprecated

POST/v0/open-app

- Beeper Desktop API server http\://localhost:23373/v0/open-app

Open Beeper Desktop and optionally navigate to a specific chat, message, or pre-fill draft text and attachment. **Use [`POST /v1/focus`](/desktop-api-reference/resources/app/methods/open/index.md) instead.**

## Request Body

Select media typeapplication/json

object

**chatID**

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

string

##### Example

```
!NCdzlIaMjZUmvmvyHU:beeper.com
```

**messageID**

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

string

**draftText**

Optional draft text to populate in the message input field.

string

**draftAttachmentPath**

Optional draft attachment path to populate in the message input field.

string

## Responses

### 200

Tool executed successfully

Select media typeapplication/json

Response indicating successful app opening.

object

**success**

required

Whether the app was successfully opened/focused.

boolean

### 400

Invalid request parameters

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 401

Access token is missing or invalid

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 403

Access token does not have the required scope

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 404

Resource not found

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 422

Unprocessable entity - validation error

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 429

Too many requests - rate limit exceeded

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string

### 500

Internal server error

Select media typeapplication/json

object

**error**

required

Error message

string

**code**

Error code

string

**details**

Additional error details

object

***key***

additional properties

string