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

# Update a team

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

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/team/{team_id}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `teams_read`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)