组织

新增组织成员

把一个既有的 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"
    }
  }
}