---
title: "Update flag link"
method: PATCH
path: "/api/v2/flag-links/projects/{projectKey}/flags/{featureFlagKey}/{id}"
tags: ["Flag links (beta)"]
---

# Update flag link

`PATCH /api/v2/flag-links/projects/{projectKey}/flags/{featureFlagKey}/{id}`

Update a flag link. Updating a flag link uses a [JSON patch](https://datatracker.ietf.org/doc/html/rfc6902) representation of the desired changes. To learn more, read [Updates](https://launchdarkly.com/docs/api#updates).

## Path parameters

- `projectKey` string, string, required — The project key
- `featureFlagKey` string, string, required — The feature flag key
- `id` string, string, required — The flag link ID

## Request body

- PatchOperation[]
  - `op` string, required — The type of operation to perform
  - `path` string, required — A JSON Pointer string specifying the part of the document to operate on
  - `value` string — A JSON value used in "add", "replace", and "test" operations

## Response `200`

Flag link response

- FlagLinkRep
  - `_links` object, required — The location and content type of related resources
  - `_key` string — The flag link key
  - `_integrationKey` string — The integration key for an integration whose <code>manifest.json</code> includes the <code>flagLink</code> capability, if this is a flag link for an existing integration
  - `_id` string, required — The ID of this flag link
  - `_deepLink` string, required — The URL for the external resource the flag is linked to
  - `_timestamp` TimestampRep, required
    - `milliseconds` integer
    - `seconds` integer
    - `rfc3339` string
    - `simple` string
  - `title` string — The title of the flag link
  - `description` string — The description of the flag link
  - `_metadata` object — The metadata required by this integration in order to create a flag link, if this is a flag link for an existing integration. Defined in the integration's <code>manifest.json</code> file under <code>flagLink</code>.
  - `_createdAt` integer, required
  - `_member` FlagLinkMember
    - `_links` object, required
    - `_id` string, required
    - `firstName` string
    - `lastName` string

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Invalid resource identifier
- `409` — Status conflict
- `429` — Rate limited

---

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