Teams API

Teams group creators, roles, and projects. Tokens always resolve a single team via the mandatory scope:team:<uuid> tuple in their abilities array, and these endpoints let you introspect and manage the teams your account can act on.

Creating a team is a Growth capability; deleting one is not. Create and update require a platform tier that includes Teams; on a lower tier they return 403 TEAM_TIER_REQUIRED and change nothing, the same gate the dashboard applies at Settings → Teams. Delete is not gated. See what the tier gates below.

Background

What the tier gatesCopy Anchor Link

Teams, roles and groups sell on the Growth tier, so one rule runs through every write in this part of the API:

Granting access is a paid capability. Withdrawing it is not.

	Gated on Growth
Create a team, role or group	Yes
Rename or re-permission one	Yes
Invite a collaborator, or change their role	Yes
Delete a team, role or group	No
Remove a collaborator, or withdraw an invitation	No
Replace a group's members	Only if the sync adds somebody

The asymmetry is deliberate. A creator who drops below Growth still has collaborators attached, and gating removal would leave them unable to revoke access they no longer want to be paying for; a downgrade would become a permanent grant. So the tier decides what you can build, never what you can take apart.

The same rule holds on the MCP tools and in the dashboard.

EndpointsCopy Anchor Link

Related

Team Members APIInvite, re-role and remove collaboratorsRoles APIThe permission sets a member can holdGroups APINamed permission bundles several people shareteam.* eventsTeam creation, rename, deletion, and membership changes.