Cập nhật thành viên

Cập nhật một phần cho vai trò, phân công team, hoặc ngân sách hàng tháng của thành viên — chỉ các trường có mặt rõ ràng trong body mới bị thay đổi. Chỉ org_admin của tổ chức đó mới gọi được. Endpoint này **không có** biện pháp bảo vệ "không thể hạ cấp org_admin cuối cùng" (bảo vệ đó chỉ tồn tại khi xóa) — về nguyên tắc có thể hạ cấp tất cả org_admin theo cách này, khiến tổ chức không còn ai. Đây là hành vi hiện tại đã được xác minh, không phải đơn giản hóa tài liệu.

PATCH/api/v1/orgs/:orgId/members/:memberId

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Tham số đường dẫn

orgIdbắt buộc

string

ID tổ chức, lấy từ phản hồi GET /orgs.

memberIdbắt buộc

string

ID thành viên, lấy từ phản hồi liệt kê thành viên hoặc thêm thành viên.

Body

role

string

Vai trò mới của thành viên.

org_adminbilling_viewerteam_adminmember

teamId

string | null

Gán lại thành viên vào một team đã cho; truyền null để hủy gán team.

monthlyBudget

number | null

Ngân sách hàng tháng (USD); truyền null để xóa.

PATCH /api/v1/orgs/:orgId/members/:memberId

1
2
3
4
curl -X PATCH https://bazaarlink.ai/api/v1/orgs/org_abc123/members/orgmem_abc123 \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"role": "team_admin"}'

Ví dụ phản hồi

Đã cập nhật. Trả về trạng thái hiện tại của thành viên.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "member": {
    "id": "orgmem_abc123",
    "role": "team_admin",
    "monthlyBudget": 100,
    "joinedAt": "2026-04-01T00:00:00.000Z",
    "teamId": "team_abc123",
    "user": {
      "id": "usr_xyz789",
      "name": "Jane Doe",
      "email": "jane@acme.com"
    },
    "team": {
      "id": "team_abc123",
      "name": "Engineering"
    }
  }
}