Tài liệu

Tham chiếu

Xoá thư mục chat

Xoá một thư mục trên Telegram. Chat trong đó không bị đụng tới — vẫn ở Tất cả chat và các thư mục khác.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Xoá một thư mục trên Telegram. Chat trong đó không bị đụng tới — vẫn ở Tất cả chat và các thư mục khác.

Thông tin

Tên Giá trị
Mã folders.delete
Scope cần messages.manage
Mức Nguy hiểm
Có thể cần xác nhận Có
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.33
Trong app Hộp thư → chọn 1 tài khoản → tab thư mục → Sửa thư mục

Trường vào

Trường Kiểu Bắt buộc Mô tả
accountId uuid Có
telegramId số nguyên Có

Ví dụ gọi

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

Trường ra (data)

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

Ví dụ trả về

{
  "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: "folders.delete". Tên tool khi được liệt kê: folders_delete.

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0