チームを更新

チームを部分更新します——body に明示的に含まれるフィールドのみが変更されます(明示的な null はそのフィールドをクリアし、省略すると既存の値がそのまま維持されます)。呼び出せるのはその組織の org_admin のみです。名前変更時に他のチーム名との重複チェックは行われません——原理的には重複名になり得ます。これは検証済みの現行動作であり、文書の簡略化ではありません。

PATCH/api/v1/orgs/:orgId/teams/:teamId

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

パスパラメータ

orgId必須

string

組織 ID。GET /orgs のレスポンスから取得します。

teamId必須

string

チーム ID。チーム一覧またはチーム作成のレスポンスから取得します。

Body

name

string

新しいチーム名。前後の空白は削除されます。

costCenterCode

string | null

コストセンターコード。null を渡すとクリアされます。

monthlyBudget

number | null

月間予算(米ドル)。null を渡すとクリアされます。

PATCH /api/v1/orgs/:orgId/teams/:teamId

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

レスポンス例

更新成功。チームの最新状態を返します。

1
2
3
4
5
6
7
8
9
{
  "team": {
    "id": "team_abc123",
    "name": "Engineering",
    "costCenterCode": "ENG-01",
    "monthlyBudget": 750,
    "createdAt": "2026-06-01T00:00:00.000Z"
  }
}