---
title: "Lưu trữ / bỏ lưu trữ"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/conversations.archive
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Lưu trữ / bỏ lưu trữ

Đưa cuộc trò chuyện vào (hoặc ra khỏi) thư mục Lưu trữ của Telegram cho tài khoản này.

Đưa cuộc trò chuyện vào (hoặc ra khỏi) thư mục Lưu trữ của Telegram cho tài khoản này.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `conversations.archive` |
| Scope cần | `messages.manage` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Xếp việc cho máy chạy |
| Cần `Idempotency-Key` | Có |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Cần máy chạy từ bản | `1.0.15` |
| Trong app | Hộp thư → menu chat → Lưu trữ |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |
| `archived` | `đúng/sai` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/conversations.archive \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000","archived":true}'
```

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `jobId` | `chữ` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}
```

## Dùng qua MCP

Không có tên sẵn trong profile nào: gọi `tools_describe` rồi `tools_run` với `code: "conversations.archive"`. Tên tool khi được liệt kê: `conversations_archive`.