組織

建立團隊

在指定組織下建立一個新團隊。只有該組織的 org_admin 能呼叫。團隊名稱在同一組織內必須唯一(區分大小寫的精確比對),重複會回 409。

POST/api/v1/orgs/:orgId/teams

驗證

Authorization必填

string · header

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

路徑參數

orgId必填

string

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

Body

name必填

string

團隊名稱,會自動去除頭尾空白。

costCenterCode

string | null

選填的成本中心代碼,純字串欄位,不驗證格式。

monthlyBudget

number | null

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

POST /api/v1/orgs/:orgId/teams

1
2
3
4
curl -X POST https://bazaarlink.ai/api/v1/orgs/org_abc123/teams \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Engineering", "monthlyBudget": 500}'

回應範例

建立成功。

1
2
3
4
5
6
7
8
9
{
  "team": {
    "id": "team_abc123",
    "name": "Engineering",
    "costCenterCode": null,
    "monthlyBudget": 500,
    "createdAt": "2026-07-27T00:00:00.000Z"
  }
}