Create a team

Creates a new team within the given organization. Only an org_admin of that organization may call this. Team names must be unique within the organization (an exact, case-sensitive match) — a duplicate returns 409.

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

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.

Body

namerequired

string

Team name; leading/trailing whitespace is trimmed.

costCenterCode

string | null

Optional cost-center code, a plain string field with no format validation.

monthlyBudget

number | null

Optional monthly budget figure in USD, with no range validation.

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

Response examples

Created.

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