Update a team

Partially updates a team — only fields explicitly present in the body are changed (an explicit null clears that field; omitting it leaves the existing value unchanged). Only an org_admin of that organization may call this. Renaming does not re-check for a collision with another team's name — it is possible, in principle, to end up with a duplicate name this way; this is verified current behavior, not a documentation simplification.

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

Authorizations

Authorizationrequired

string · header

API key as bearer token in the Authorization header.

Path parameters

orgIdrequired

string

The organization ID, from a GET /orgs response.

teamIdrequired

string

The team ID, from a list-teams or create-a-team response.

Body

name

string

New team name; leading/trailing whitespace is trimmed.

costCenterCode

string | null

Cost-center code; pass null to clear it.

monthlyBudget

number | null

Monthly budget in USD; pass null to clear it.

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

Response examples

Updated. Returns the team's current state.

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