チームを作成

指定した組織内に新しいチームを作成します。呼び出せるのはその組織の org_admin のみです。チーム名は組織内で一意である必要があります(大文字・小文字を区別する完全一致)——重複すると 409 を返します。

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

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして 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"
  }
}