組織

更新組織成員

部分更新一個成員的角色、所屬團隊或每月預算——只有 body 裡明確帶到的欄位會被改動。只有該組織的 org_admin 能呼叫。這支**沒有**「不能把最後一個 org_admin 降級」的保護(那個保護只在刪除成員時才有),理論上可能把一個組織的 org_admin 全部降級掉——這是目前真實行為,不是文件簡化。

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

驗證

Authorization必填

string · header

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

路徑參數

orgId必填

string

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

memberId必填

string

成員 ID,取自列出成員或新增成員的回應。

Body

role

string

新的成員角色。

org_adminbilling_viewerteam_adminmember

teamId

string | null

重新指派到指定團隊;傳 null 取消團隊指派。

monthlyBudget

number | null

每月預算(美元);傳 null 清空。

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

回應範例

更新成功,回傳成員最新狀態。

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