---
title: "Update a team"
method: PATCH
path: "/api/v2/team/{team_id}"
tags: ["Teams"]
---

# Update a team

`PATCH /api/v2/team/{team_id}`

Update a team using the team's `id`.
If the `team_links` relationship is present, the associated links are updated to be in the order they appear in the array, and any existing team links not present are removed.

## Path parameters

- `team_id` string, required

## Request body

- TeamUpdateRequest — Team update request
  - `data` TeamUpdate, required — Team update request
    - `attributes` TeamUpdateAttributes, required — Team update attributes
      - `avatar` string, nullable — Unicode representation of the avatar for the team, limited to a single grapheme
      - `banner` integer, nullable — Banner selection for the team
      - `description` string — Free-form markdown description/content for the team's homepage
      - `handle` string, required — The team's identifier
      - `hidden_modules` string[] — Collection of hidden modules for the team
      - `name` string, required — The name of the team
      - `visible_modules` string[] — Collection of visible modules for the team
    - `relationships` TeamUpdateRelationships — Team update relationships
      - `team_links` RelationshipToTeamLinks — Relationship between a team and a team link
        - `data` RelationshipToTeamLinkData[] — Related team links
          - `id` string, required — The team link's identifier
          - `type` 'team_links', required — Team link type
        - `links` TeamRelationshipsLinks — Links attributes.
          - `related` string — Related link.
    - `type` 'team', required — Team type

## Response `200`

OK

- TeamResponse — Response with a team
  - `data` Team — A team
    - `attributes` TeamAttributes, required — Team attributes
      - `avatar` string, nullable — Unicode representation of the avatar for the team, limited to a single grapheme
      - `banner` integer, nullable — Banner selection for the team
      - `created_at` string, date-time — Creation date of the team
      - `description` string, nullable — Free-form markdown description/content for the team's homepage
      - `handle` string, required — The team's identifier
      - `hidden_modules` string[], nullable — Collection of hidden modules for the team
      - `is_managed` boolean — Whether the team is managed from an external source
      - `link_count` integer — The number of links belonging to the team
      - `modified_at` string, date-time — Modification date of the team
      - `name` string, required — The name of the team
      - `summary` string, nullable — A brief summary of the team, derived from the `description`
      - `user_count` integer — The number of users belonging to the team
      - `visible_modules` string[], nullable — Collection of visible modules for the team
    - `id` string, required — The team's identifier
    - `relationships` TeamRelationships — Resources related to a team
      - `team_links` RelationshipToTeamLinks — Relationship between a team and a team link
        - `data` RelationshipToTeamLinkData[] — Related team links
          - `id` string, required — The team link's identifier
          - `type` 'team_links', required — Team link type
        - `links` TeamRelationshipsLinks — Links attributes.
          - `related` string — Related link.
      - `user_team_permissions` RelationshipToUserTeamPermission — Relationship between a user team permission and a team
        - `data` RelationshipToUserTeamPermissionData, nullable — Related user team permission data
          - `id` string, required — The ID of the user team permission
          - `type` 'user_team_permissions', required — User team permission type
        - `links` TeamRelationshipsLinks — Links attributes.
          - `related` string — Related link.
    - `type` 'team', required — Team type

## Other responses

- `400` — API error response.
- `403` — Forbidden
- `404` — API error response.
- `409` — API error response.
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)