delete_team

Purpose

Deletes a team. Only the owner may do it — destroying the container everyone else works in is not something a member can decide.

Irreversible, and it takes everything with it

A team is the tenant that projects, plans, subscriptions, roles and groups hang off. Deleting one is not a tidy-up; confirm with a human before calling this. The tool is annotated destructive so a client can prompt for confirmation.

Unlike create_team and update_team, this is not tier-gated. A creator whose tier lapsed has to be able to take access away. See what the tier gates.

Required ability

team:delete

Input schema

{
  "type": "object",
  "properties": {
    "team_id": {
      "type": "string",
      "description": "UUID of the team to delete. Irreversible."
    }
  },
  "required": ["team_id"]
}

Output shape

{
  "data": {
    "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
    "deleted": true
  }
}

Emits team.deleted.

Example prompts

"Delete the team we set up for the pilot — it's finished and empty."

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks team:delete.
RESOURCE_NOT_FOUND — no such team, or the caller is not a member.
VALIDATION_FAILED — the caller is a member but not the owner.

create_team
update_team
remove_team_member — the narrower way to withdraw one person's access.
Teams API