team.updated

project_id is always null for team events.

When this fires

A team's name changes.

That is the whole of it today — name is the only mutable field on a team. Ownership does not transfer, and the tier a team sits on is a property of the owner's billing rather than of the team, so neither shows up here.

Fires however the rename happened

The team model dispatches this from its own event map, not from any one code path. A rename through the REST endpoint, through the update_team MCP tool, or from a console fix that went near either, all emit it identically. The dashboard has no rename control today, so the API and MCP are the only routes.

Required ability

team:view — the token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "team.updated",
  "created_at": "2026-08-31T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": null,
  "data": {
    "team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
    "name": "Northwind Studios",
    "owner_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `team.updated` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	null	Always `null` — account-level event.
`data.team_id`	string UUID	The team that was renamed.
`data.name`	string	The new name. The previous one is not carried.
`data.owner_id`	string UUID	The team owner. Unchanged by a rename; included so a consumer can attribute the team without a second call.

Caveats

No before value. The payload carries the name the team has now, not the one it had. If your mirror needs the old name, keep it from the previous event or read it before applying.
A team has no code. Unlike roles and groups, teams are addressed only by team_id, so a rename never breaks a reference.
Renaming has no effect on membership, roles, groups, projects or billing.

team.created — predecessor.
team.deleted — terminal state.
Team events overview — back to family overview.