create_team

Purpose

Creates a team owned by the caller. Teams are the tenant every project, plan and subscription hangs off; the caller becomes the owner, which is not a membership row and cannot later be removed or re-roled.

Growth-tier capability. On a lower tier this returns TEAM_TIER_REQUIRED and creates nothing. See what the tier gates.

Required ability

team:create

Input schema

{
  "type": "object",
  "properties": {
    "name": { "type": "string", "description": "Team name, 1..255 characters." }
  },
  "required": ["name"]
}

Output shape

{
  "data": {
    "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
    "name": "Research Collective",
    "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80"
  }
}

Emits team.created.

Example prompts

"Create a team called Research Collective."

"Set up a separate team for the client work so their projects are isolated."

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks team:create.
TEAM_TIER_REQUIRED — the caller's platform tier does not include Teams.
VALIDATION_FAILED — name empty or longer than 255 characters.

update_team
delete_team
create_role — a new team seeds admin, manager and viewer; add your own after.
Teams API