---
title: "Update a Team"
method: PATCH
path: "/v3/teams/{teamId}"
tags: ["v3 teams"]
---

# Update a Team

`PATCH /v3/teams/{teamId}`

Update a team, the authenticated user must be the "Administrator" or a "Manager" of the team.

## Request body

- GFWTeam
  - `name` string, required
  - `createdAt` string, date-time, required

## Response `200`

Example response

- object
  - `data` object, required
    - `type` string, required
    - `id` string, required
    - `attributes` GFWTeam, required
      - `name` string, required
      - `createdAt` string, date-time, required

## Other responses

- `400` — Error Response
- `401` — Error Response
- `404` — Error Response

## Changes

- **2022-05-19** `4bc9eb243ae0` — 4 info
  - the response property `data` became required for the status `200`
  - the response property `data/attributes` became required for the status `200`
  - the response property `data/id` became required for the status `200`
  - the response property `data/type` became required for the status `200`
- **2022-05-05** `9de002b42c17` — 2 info
  - api tag `v3 teams` added
  - api tag `v3` removed
- **2022-04-29** `318e32d5b89c` — 1 breaking, 1 info
  - the request property `name` became required
  - the response property `data/attributes/name` became required for the status `200`
- **2022-04-29** `4f941278441f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/wri/apis/fw-teams/changes/v3/teams/:teamId/patch.md)

---

[API](https://skmtc.dev/wri/apis/fw-teams.md) · [All operations](https://skmtc.dev/wri/apis/fw-teams/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wri/fw-teams/revisions/9e208e657f30/schema)