---
title: "👤 Update a team."
method: PUT
path: "/team/{id}"
tags: ["team", "default"]
---

# 👤 Update a team.

`PUT /team/{id}`

## Request

- Base URL: `{{ server_url }}/v1`
- URL: `{{ server_url }}/v1/team/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/athenian/apis/title/docs/team/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Request body

- TeamUpdateRequest: Team update request.
  - `name` string, required: New name of the team.
  - `members` DeveloperID[], required: A set of developers. An empty list disables the filter and includes everybody. Duplicates are automatically ignored.
  - `parent` integer, nullable, required: New identifier of the higher level team.

## Response `200`

Empty object indicates a successful operation.

- [object Object]

## Other responses

- `400`: The request is invalid.
- `403`: The user is forbidden to update the specified team.
- `404`: The specified team was not found.
- `409`: There is an existing team with the same contents.

---

[API](https://skmtc.dev/athenian/apis/title.md) - [All operations](https://skmtc.dev/athenian/apis/title/llms.txt) - [OpenAPI document](https://skmtc.dev/athenian/apis/title/revisions/110c9f7cffdd?raw)