Tài liệu

Tham chiếu

Đổi vai trò thành viên

Đổi vai trò của một người.

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

Đổi vai trò của một người.

Thông tin

Tên Giá trị
Mã members.set_role
Scope cần members.manage
Mức Nguy hiểm
Có thể cần xác nhận Có
Kiểu chạy Trả kết quả ngay
Cần Idempotency-Key Không
Vai trò thành viên được phép owner, manager
Trong app Cài đặt → Thành viên

Trường vào

Trường Kiểu Bắt buộc Mô tả
memberId uuid Có
role "owner" | "manager" | "agent" | "viewer" Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/members.set_role \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"memberId":"00000000-0000-0000-0000-000000000000","role":"owner"}'

Trường ra (data)

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

Ví dụ trả về

{
  "data": {
    "ok": true
  }
}

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: "members.set_role". Tên tool khi được liệt kê: members_set_role.

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

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