Thêm thành viên

Thêm một người dùng BazaarLink đã có (tra cứu theo email) vào tổ chức đã cho. Endpoint này **không tạo tài khoản mới, không gửi email mời** — người đó phải đã có tài khoản BazaarLink, nếu không request trả về 404. role mặc định là member khi bỏ qua; giá trị hợp lệ là org_admin, billing_viewer, team_admin, và member. Chỉ org_admin của tổ chức đó mới gọi được.

POST/api/v1/orgs/:orgId/members

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.

Body

emailbắt buộc

string

Email của người dùng cần thêm, khớp không phân biệt hoa thường và đã cắt khoảng trắng.

role

string

Vai trò của thành viên, mặc định là member khi bỏ qua.

org_adminbilling_viewerteam_adminmember

Example: "member"

teamId

string | null

Gán thành viên vào một team đã cho (từ phản hồi liệt kê team); bỏ qua hoặc null nghĩa là không gán team.

monthlyBudget

number | null

Số ngân sách hàng tháng tùy chọn (USD), không kiểm tra phạm vi.

POST /api/v1/orgs/:orgId/members

1
2
3
4
curl -X POST https://bazaarlink.ai/api/v1/orgs/org_abc123/members \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com", "role": "member", "teamId": "team_abc123"}'

Ví dụ phản hồi

Đã thêm.

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