# Rename a team, or replace its members

`PATCH /api/v1/teams/{id}`

MCP tool: `update-team`

Writes only the fields sent. `members` replaces the whole set, so send everyone who stays.

## Parameters

- `id` (path, required) — The team's `team_…` id, as `get-project` lists it.

## Responses

- `200` — The team
- `400` — The request body or query string does not match the operation's schema
- `401` — No Flow access token was presented, or it is not valid
- `404` — No such project, or none this caller is a member of