組織

新增組織成員

把一個既有的 BazaarLink 使用者(以 email 查找)加入指定組織。這支**不會建立新帳號、不會寄邀請信**——對方必須已經在 BazaarLink 有帳號,否則回 404。role 省略時預設 member,合法值為 org_admin、billing_viewer、team_admin、member 四種。只有該組織的 org_admin 能呼叫。

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

驗證

Authorization必填

string · header

在 Authorization 標頭以 Bearer token 傳入 API 金鑰。

路徑參數

orgId必填

string

組織 ID,取自 GET /orgs 回應。

Body

email必填

string

要加入的使用者 email,不區分大小寫比對,會自動去除頭尾空白。

role

string

成員角色,省略時預設 member。

org_adminbilling_viewerteam_adminmember

Example: "member"

teamId

string | null

指派到指定團隊(取自列出團隊的回應),省略或 null 表示不指派任何團隊。

monthlyBudget

number | null

選填的每月預算數字(美元),不做範圍驗證。

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"}'

回應範例

新增成功。

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"
    }
  }
}