---
title: "Thành viên và lời mời"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/members.list
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Thành viên và lời mời

Thành viên (vai trò, tài khoản được giao) và lời mời đang chờ.

Thành viên (vai trò, tài khoản được giao) và lời mời đang chờ.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `members.list` |
| Scope cần | `members.manage` |
| Mức | Chỉ đọc |
| Có thể cần xác nhận | Không |
| 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`, `agent`, `viewer` |
| Trong app | Cài đặt → Thành viên |

## Trường vào

Thao tác không cần trường nào.

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/members.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

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

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `members` | `đối tượng[]` | Có |
| `invites` | `đối tượng[]` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "members": [
      {
        "name": "text",
        "email": "text",
        "accountIds": [
          "text"
        ],
        "id": "00000000-0000-4000-8000-000000000000",
        "user_id": "00000000-0000-4000-8000-000000000000",
        "role": "owner",
        "created_at": "2026-10-22T12:00:00.000Z"
      }
    ],
    "invites": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "email": "text",
        "role": "owner",
        "account_ids": [
          "text"
        ],
        "expires_at": "2026-10-22T12:00:00.000Z",
        "created_at": "2026-10-22T12:00:00.000Z"
      }
    ]
  }
}
```

## 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.list"`. Tên tool khi được liệt kê: `members_list`.