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

# Update a team link

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

Update a team link.

## Path parameters

- `team_id` string, required
- `link_id` string, required

## Request body

- TeamLinkCreateRequest — Team link create request
  - `data` TeamLinkCreate, required — Team link create
    - `attributes` TeamLinkAttributes, required — Team link attributes
      - `label` string, required — The link's label
      - `position` integer — The link's position, used to sort links for the team
      - `team_id` string — ID of the team the link is associated with
      - `url` string, required — The URL for the link
    - `type` 'team_links', required — Team link type

## Response `200`

OK

- TeamLinkResponse — Team link response
  - `data` TeamLink — Team link
    - `attributes` TeamLinkAttributes, required — Team link attributes
      - `label` string, required — The link's label
      - `position` integer — The link's position, used to sort links for the team
      - `team_id` string — ID of the team the link is associated with
      - `url` string, required — The URL for the link
    - `id` string, required — The team link's identifier
    - `type` 'team_links', required — Team link type

## Other responses

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

---

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