---
title: "Update view"
method: PATCH
path: "/api/v2/projects/{projectKey}/views/{viewKey}"
tags: ["Views (beta)"]
---

# Update view

`PATCH /api/v2/projects/{projectKey}/views/{viewKey}`

Edit an existing view.

The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields.

Here's an example:
  ```
    {
      "description": "Example updated description",
      "tags": ["new-tag"]
    }
  ```

## Path parameters

- `projectKey` string, required
- `viewKey` string, required

## Headers

- `LD-API-Version` 'beta', required

## Request body

- ViewPatch
  - `name` string — Human-readable name for the view
  - `description` string — Optional detailed description of the view
  - `generateSdkKeys` boolean — Whether to generate SDK keys for this view
  - `maintainerId` string — Member ID of the maintainer for this view. Only one of `maintainerId` or `maintainerTeamKey` can be specified.
  - `maintainerTeamKey` string — Key of the maintainer team for this view. Only one of `maintainerId` or `maintainerTeamKey` can be specified.
  - `tags` string[] — Tags associated with this view
  - `archived` boolean — Whether or not the view is archived

## Response `200`

Successful response

- View
  - `_access` ViewsAccessRep
    - `denied` ViewsAccessDenied[], required
      - `action` string, required
      - `reason` ViewsAccessDeniedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
    - `allowed` ViewsAccessAllowedRep[], required
      - `action` string, required
      - `reason` ViewsAccessAllowedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
  - `_links` ParentAndSelfLinks — The location and content type of related resources
    - `self` CoreLink, required
      - `href` string, required
      - `type` string, required
    - `parent` CoreLink, required
      - `href` string, required
      - `type` string, required
  - `id` string, string, required — Unique ID of this view
  - `accountId` string, required — ID of the account that owns this view
  - `projectId` string, required — ID of the project this view belongs to
  - `projectKey` string, required — Key of the project this view belongs to
  - `key` string, required — Unique key for the view within the account/project
  - `name` string, required — Human-readable name for the view
  - `description` string, required — Optional detailed description of the view
  - `generateSdkKeys` boolean, required — Whether to generate SDK keys for this view. Defaults to false.
  - `version` integer, required — Version number for tracking changes
  - `tags` string[], required — Tags associated with this view
  - `createdAt` integer, required
  - `updatedAt` integer, required
  - `archived` boolean, required — Whether this view is archived
  - `archivedAt` integer
  - `deletedAt` integer
  - `deleted` boolean, required — Whether this view is deleted
  - `maintainer` Maintainer
    - `id` string, required
    - `kind` string, required
    - `maintainerMember` ViewsMaintainerMember
      - `id` string, required
      - `email` string, required
      - `role` string, required
      - `firstName` string
      - `lastName` string
    - `maintainerTeam` ViewsMaintainerTeam
      - `id` string, required
      - `key` string, required
      - `name` string, required
  - `flagsSummary` FlagsSummary
    - `count` integer, required
    - `linkedFlags` ExpandedDirectlyLinkedFlags
      - `items` ExpandedDirectlyLinkedFlag[], required
        - `key` string, required
        - `name` string, required
        - `links` ViewsSelfLink, required
          - `self` CoreLink, required
            - `href` string, required
            - `type` string, required
      - `totalCount` integer, required
  - `segmentsSummary` SegmentsSummary
    - `count` integer, required
    - `linkedSegments` ExpandedDirectlyLinkedSegments
      - `items` ExpandedDirectlyLinkedSegment[], required
        - `key` string, required
        - `name` string, required
        - `environmentId` string, required
        - `links` ViewsSelfLink, required
          - `self` CoreLink, required
            - `href` string, required
            - `type` string, required
      - `totalCount` integer, required
  - `metricsSummary` MetricsSummary
    - `count` integer, required
  - `aiConfigsSummary` AIConfigsSummary
    - `count` integer, required
  - `resourceSummary` ResourceSummary
    - `flagCount` integer, required
    - `segmentCount` integer
    - `metricCount` integer
    - `aiConfigCount` integer
    - `totalCount` integer, required
  - `flagsExpanded` ExpandedLinkedFlags — Details on linked flags for a view - requires passing the 'allFlags' expand field
    - `items` ExpandedFlag[], required
      - `key` string, required — A unique key used to reference the flag
      - `name` string, required — A human-friendly name for the flag
      - `description` string — Description of the flag
      - `creationDate` integer — Creation date in milliseconds
      - `_version` integer — Version of the flag
      - `archived` boolean — Whether the flag is archived
      - `tags` string[] — Tags for the flag
      - `temporary` boolean — Whether the flag is temporary
      - `includeInSnippet` boolean — Whether to include in snippet
      - `maintainer` ExpandedFlagMaintainer
        - `key` string, required — The ID of the maintainer member, or the key of the maintainer team
        - `kind` 'member' | 'team', required — The type of the maintainer
        - `_member` ViewsMemberSummary
          - `_links` object, required — The location and content type of related resources
          - `_id` string, required — The member's ID
          - `firstName` string — The member's first name
          - `lastName` string — The member's last name
          - `role` string, required — The member's base role. If the member has no additional roles, this role will be in effect.
          - `email` string, required — The member's email address
        - `_team` ViewsMemberTeamSummaryRep
          - `customRoleKeys` string[], required — A list of keys of the custom roles this team has access to
          - `key` string, required — The team key
          - `_links` object
          - `name` string, required — The team name
      - `_links` ParentAndSelfLinks — The location and content type of related resources
        - `self` CoreLink, required
          - `href` string, required
          - `type` string, required
        - `parent` CoreLink, required
          - `href` string, required
          - `type` string, required
    - `totalCount` integer, required
  - `segmentsExpanded` ExpandedLinkedSegments — Details on linked segments for a view - requires passing the 'allSegments' expand field
    - `items` ExpandedSegment[], required
      - `key` string, required — A unique key used to reference the segment
      - `name` string, required — A human-friendly name for the segment
      - `environmentId` string — Environment ID of the segment
      - `environmentKey` string — Environment key of the segment
      - `description` string — Description of the segment
      - `creationDate` integer — Creation date in milliseconds
      - `lastModifiedDate` integer — Last modification date in milliseconds
      - `deleted` boolean — Whether the segment is deleted
      - `tags` string[] — Tags for the segment
      - `unbounded` boolean — Whether the segment is unbounded
      - `version` integer — Version of the segment
      - `generation` integer — Generation of the segment
      - `_links` ParentAndSelfLinks — The location and content type of related resources
        - `self` CoreLink, required
          - `href` string, required
          - `type` string, required
        - `parent` CoreLink, required
          - `href` string, required
          - `type` string, required
    - `totalCount` integer, required
  - `metricsExpanded` ExpandedLinkedMetrics
    - `items` ExpandedMetric[], required
      - `key` string — A unique key used to reference the metric
      - `name` string — A human-friendly name for the metric
      - `creationDate` integer — Creation date in milliseconds
      - `lastModified` integer — Last modification date in milliseconds
      - `isActive` boolean — Whether the metric is active
      - `eventKey` string — Event key for the metric
      - `_id` string — ID of the metric
      - `_versionId` string — Version ID of the metric
      - `kind` string — Kind of the Metric
      - `category` string — Category of the Metric
      - `description` string — Description of the Metric
      - `isNumeric` boolean
      - `lastSeen` integer — Last seen date in milliseconds
      - `_links` ParentAndSelfLinks — The location and content type of related resources
        - `self` CoreLink, required
          - `href` string, required
          - `type` string, required
        - `parent` CoreLink, required
          - `href` string, required
          - `type` string, required
    - `totalCount` integer, required
  - `aiConfigsExpanded` ExpandedLinkedAIConfigs
    - `items` ExpandedAIConfig[], required
      - `key` string — A unique key used to reference the AI config
      - `name` string — A human-friendly name for the AI config
      - `tags` string[] — Tags for the AI config
      - `description` string — Description of the AI config
      - `version` integer — Version of the AI config
      - `createdAt` integer — Creation date in milliseconds
      - `updatedAt` integer — Last modification date in milliseconds
      - `flagKey` string — Key of the flag that this AI config is attached to
      - `_links` ParentAndSelfLinks — The location and content type of related resources
        - `self` CoreLink, required
          - `href` string, required
          - `type` string, required
        - `parent` CoreLink, required
          - `href` string, required
          - `type` string, required
    - `totalCount` integer, required
  - `resourcesExpanded` ExpandedLinkedResources — Details on linked resources for a view - requires passing the 'allResources' expand field
    - `items` ExpandedLinkedResourcesItems, required
      - `flags` ExpandedLinkedResourcesFlags, required
        - `items` ExpandedFlag[], required
          - `key` string, required — A unique key used to reference the flag
          - `name` string, required — A human-friendly name for the flag
          - `description` string — Description of the flag
          - `creationDate` integer — Creation date in milliseconds
          - `_version` integer — Version of the flag
          - `archived` boolean — Whether the flag is archived
          - `tags` string[] — Tags for the flag
          - `temporary` boolean — Whether the flag is temporary
          - `includeInSnippet` boolean — Whether to include in snippet
          - `maintainer` ExpandedFlagMaintainer
            - `key` string, required — The ID of the maintainer member, or the key of the maintainer team
            - `kind` 'member' | 'team', required — The type of the maintainer
            - `_member` ViewsMemberSummary
              - …
            - `_team` ViewsMemberTeamSummaryRep
              - …
          - `_links` ParentAndSelfLinks — The location and content type of related resources
            - `self` CoreLink, required
              - …
            - `parent` CoreLink, required
              - …
        - `totalCount` integer, required
      - `segments` ExpandedLinkedResourcesSegments
        - `items` ExpandedSegment[], required
          - `key` string, required — A unique key used to reference the segment
          - `name` string, required — A human-friendly name for the segment
          - `environmentId` string — Environment ID of the segment
          - `environmentKey` string — Environment key of the segment
          - `description` string — Description of the segment
          - `creationDate` integer — Creation date in milliseconds
          - `lastModifiedDate` integer — Last modification date in milliseconds
          - `deleted` boolean — Whether the segment is deleted
          - `tags` string[] — Tags for the segment
          - `unbounded` boolean — Whether the segment is unbounded
          - `version` integer — Version of the segment
          - `generation` integer — Generation of the segment
          - `_links` ParentAndSelfLinks — The location and content type of related resources
            - `self` CoreLink, required
              - …
            - `parent` CoreLink, required
              - …
        - `totalCount` integer, required
      - `aiConfigs` ExpandedLinkedResourcesAIConfigs
        - `items` ExpandedAIConfig[], required
          - `key` string — A unique key used to reference the AI config
          - `name` string — A human-friendly name for the AI config
          - `tags` string[] — Tags for the AI config
          - `description` string — Description of the AI config
          - `version` integer — Version of the AI config
          - `createdAt` integer — Creation date in milliseconds
          - `updatedAt` integer — Last modification date in milliseconds
          - `flagKey` string — Key of the flag that this AI config is attached to
          - `_links` ParentAndSelfLinks — The location and content type of related resources
            - `self` CoreLink, required
              - …
            - `parent` CoreLink, required
              - …
        - `totalCount` integer, required
      - `metrics` ExpandedLinkedResourcesMetrics
        - `items` ExpandedMetric[], required
          - `key` string — A unique key used to reference the metric
          - `name` string — A human-friendly name for the metric
          - `creationDate` integer — Creation date in milliseconds
          - `lastModified` integer — Last modification date in milliseconds
          - `isActive` boolean — Whether the metric is active
          - `eventKey` string — Event key for the metric
          - `_id` string — ID of the metric
          - `_versionId` string — Version ID of the metric
          - `kind` string — Kind of the Metric
          - `category` string — Category of the Metric
          - `description` string — Description of the Metric
          - `isNumeric` boolean
          - `lastSeen` integer — Last seen date in milliseconds
          - `_links` ParentAndSelfLinks — The location and content type of related resources
            - `self` CoreLink, required
              - …
            - `parent` CoreLink, required
              - …
        - `totalCount` integer, required
    - `totalCount` integer, required

## Other responses

- `400` — Bad request
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-02-28** `69c5c9aafe78` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/changes/api/v2/projects/:projectKey/views/:viewKey/patch.md)

---

[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)