---
title: Archive or unarchive a chat - Beeper Developer Docs
---

Deprecated

POST/v0/archive-chat

- Beeper Desktop API server http\://localhost:23373/v0/archive-chat

Archive or unarchive a chat. Set archived=true to move to archive, archived=false to move back to inbox. **Use [`POST /v1/chats/{chatID}/archive`](/desktop-api-reference/resources/chats/methods/archive/index.md) instead.**

## Request Body

Select media typeapplication/json

object

**chatID**

required

The identifier of the chat to archive or unarchive (accepts both chatID and local chat ID)

string

##### Example

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

**archived**

True to archive, false to unarchive

boolean

default: true

## Responses

### 200

Tool executed successfully

Select media typeapplication/json

object

**success**

required

boolean

**error**

string

### 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