Sign in

v5

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-02-283466592.5 MB
Views (beta)

Update view

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"]
  }
patch/api/v2/projects/{projectKey}/views/{viewKey}

Path parameters

projectKeystring required
viewKeystring required

Headers

LD-API-Version'beta' required

Version of the endpoint.

Request body

namestring

Human-readable name for the view

descriptionstring

Optional detailed description of the view

generateSdkKeysboolean

Whether to generate SDK keys for this view

maintainerIdstring

Member ID of the maintainer for this view. Only one of maintainerId or maintainerTeamKey can be specified.

maintainerTeamKeystring

Key of the maintainer team for this view. Only one of maintainerId or maintainerTeamKey can be specified.

tagsstring[]

Tags associated with this view

archivedboolean

Whether or not the view is archived

Example request

{
  "archived": true,
  "maintainerId": "maintainerId",
  "name": "name",
  "generateSdkKeys": true,
  "maintainerTeamKey": "maintainerTeamKey",
  "description": "description",
  "tags": [
    "tags",
    "tags"
  ]
}

Response

Successful response

idstring string required

Unique ID of this view

accountIdstring required

ID of the account that owns this view

projectIdstring required

ID of the project this view belongs to

projectKeystring required

Key of the project this view belongs to

keystring required

Unique key for the view within the account/project

namestring required

Human-readable name for the view

descriptionstring required

Optional detailed description of the view

generateSdkKeysboolean required

Whether to generate SDK keys for this view. Defaults to false.

versioninteger required

Version number for tracking changes

tagsstring[] required

Tags associated with this view

createdAtinteger required
updatedAtinteger required
archivedboolean required

Whether this view is archived

archivedAtinteger
deletedAtinteger
deletedboolean required

Whether this view is deleted

Example response

{
  "metricsExpanded": {
    "totalCount": 6,
    "items": [
      {
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "kind": "kind",
        "description": "description",
        "creationDate": 9,
        "isActive": true,
        "lastSeen": 3,
        "eventKey": "eventKey",
        "_versionId": "_versionId",
        "isNumeric": true,
        "name": "name",
        "lastModified": 6,
        "_id": "_id",
        "category": "category",
        "key": "key"
      },
      {
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "kind": "kind",
        "description": "description",
        "creationDate": 9,
        "isActive": true,
        "lastSeen": 3,
        "eventKey": "eventKey",
        "_versionId": "_versionId",
        "isNumeric": true,
        "name": "name",
        "lastModified": 6,
        "_id": "_id",
        "category": "category",
        "key": "key"
      }
    ]
  },
  "_links": {
    "parent": {
      "href": "href",
      "type": "type"
    },
    "self": {
      "href": "href",
      "type": "type"
    }
  },
  "description": "description",
  "maintainer": {
    "kind": "kind",
    "maintainerMember": {
      "firstName": "firstName",
      "lastName": "lastName",
      "role": "role",
      "id": "id",
      "email": "email"
    },
    "id": "id",
    "maintainerTeam": {
      "name": "name",
      "id": "id",
      "key": "key"
    }
  },
  "metricsSummary": {
    "count": 2
  },
  "createdAt": 6,
  "archived": false,
  "projectKey": "projectKey",
  "_access": {
    "allowed": [
      {
        "reason": {
          "role_name": "role_name",
          "notActions": [
            null,
            null
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "actions": [
            "*"
          ]
        },
        "action": "action"
      },
      {
        "reason": {
          "role_name": "role_name",
          "notActions": [
            null,
            null
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "actions": [
            "*"
          ]
        },
        "action": "action"
      }
    ],
    "denied": [
      {
        "reason": {
          "role_name": "role_name",
          "notActions": [
            null,
            null
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "actions": [
            "*"
          ]
        },
        "action": "action"
      },
      {
        "reason": {
          "role_name": "role_name",
          "notActions": [
            null,
            null
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "actions": [
            "*"
          ]
        },
        "action": "action"
      }
    ]
  },
  "generateSdkKeys": true,
  "flagsSummary": {
    "count": 2,
    "linkedFlags": {
      "totalCount": 7,
      "items": [
        {
          "name": "name",
          "links": {
            "self": {
              "href": "href",
              "type": "type"
            }
          },
          "key": "key"
        },
        {
          "name": "name",
          "links": {
            "self": {
              "href": "href",
              "type": "type"
            }
          },
          "key": "key"
        }
      ]
    }
  },
  "id": "id",
  "aiConfigsSummary": {
    "count": 4
  },
  "key": "key",
  "updatedAt": 1,
  "resourcesExpanded": {
    "totalCount": 7,
    "items": {
      "flags": {
        "totalCount": 5,
        "items": [
          {
            "archived": true,
            "temporary": true,
            "includeInSnippet": true,
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "name": "name",
            "description": "description",
            "creationDate": 7,
            "_version": 1,
            "key": "key",
            "maintainer": {
              "kind": "member",
              "_member": {
                "firstName": "Ariel",
                "lastName": "Flores",
                "role": "admin",
                "_links": {
                  "self": {
                    "href": "/api/v2/members/569f183514f4432160000007",
                    "type": "application/json"
                  }
                },
                "_id": "569f183514f4432160000007",
                "email": "ariel@acme.com"
              },
              "_team": {
                "_links": {
                  "key": {
                    "href": "href",
                    "type": "type"
                  }
                },
                "name": "QA Team",
                "customRoleKeys": [
                  "access-to-test-projects"
                ],
                "key": "team-key-123abc"
              },
              "key": "key"
            },
            "tags": [
              "tags",
              "tags"
            ]
          },
          {
            "archived": true,
            "temporary": true,
            "includeInSnippet": true,
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "name": "name",
            "description": "description",
            "creationDate": 7,
            "_version": 1,
            "key": "key",
            "maintainer": {
              "kind": "member",
              "_member": {
                "firstName": "Ariel",
                "lastName": "Flores",
                "role": "admin",
                "_links": {
                  "self": {
                    "href": "/api/v2/members/569f183514f4432160000007",
                    "type": "application/json"
                  }
                },
                "_id": "569f183514f4432160000007",
                "email": "ariel@acme.com"
              },
              "_team": {
                "_links": {
                  "key": {
                    "href": "href",
                    "type": "type"
                  }
                },
                "name": "QA Team",
                "customRoleKeys": [
                  "access-to-test-projects"
                ],
                "key": "team-key-123abc"
              },
              "key": "key"
            },
            "tags": [
              "tags",
              "tags"
            ]
          }
        ]
      },
      "aiConfigs": {
        "totalCount": 3,
        "items": [
          {
            "createdAt": 2,
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "name": "name",
            "description": "description",
            "version": 1,
            "key": "key",
            "flagKey": "flagKey",
            "tags": [
              "tags",
              "tags"
            ],
            "updatedAt": 6
          },
          {
            "createdAt": 2,
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "name": "name",
            "description": "description",
            "version": 1,
            "key": "key",
            "flagKey": "flagKey",
            "tags": [
              "tags",
              "tags"
            ],
            "updatedAt": 6
          }
        ]
      },
      "metrics": {
        "totalCount": 3,
        "items": [
          {
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "kind": "kind",
            "description": "description",
            "creationDate": 9,
            "isActive": true,
            "lastSeen": 3,
            "eventKey": "eventKey",
            "_versionId": "_versionId",
            "isNumeric": true,
            "name": "name",
            "lastModified": 6,
            "_id": "_id",
            "category": "category",
            "key": "key"
          },
          {
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "kind": "kind",
            "description": "description",
            "creationDate": 9,
            "isActive": true,
            "lastSeen": 3,
            "eventKey": "eventKey",
            "_versionId": "_versionId",
            "isNumeric": true,
            "name": "name",
            "lastModified": 6,
            "_id": "_id",
            "category": "category",
            "key": "key"
          }
        ]
      },
      "segments": {
        "totalCount": 6,
        "items": [
          {
            "generation": 6,
            "lastModifiedDate": 9,
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "description": "description",
            "creationDate": 5,
            "version": 9,
            "environmentKey": "environmentKey",
            "tags": [
              "tags",
              "tags"
            ],
            "environmentId": "environmentId",
            "deleted": true,
            "name": "name",
            "unbounded": true,
            "key": "key"
          },
          {
            "generation": 6,
            "lastModifiedDate": 9,
            "_links": {
              "parent": {
                "href": "href",
                "type": "type"
              },
              "self": {
                "href": "href",
                "type": "type"
              }
            },
            "description": "description",
            "creationDate": 5,
            "version": 9,
            "environmentKey": "environmentKey",
            "tags": [
              "tags",
              "tags"
            ],
            "environmentId": "environmentId",
            "deleted": true,
            "name": "name",
            "unbounded": true,
            "key": "key"
          }
        ]
      }
    }
  },
  "resourceSummary": {
    "flagCount": 7,
    "metricCount": 1,
    "totalCount": 6,
    "segmentCount": 1,
    "aiConfigCount": 1
  },
  "version": 0,
  "tags": [
    "tags",
    "tags"
  ],
  "accountId": "accountId",
  "archivedAt": 5,
  "deletedAt": 5,
  "deleted": false,
  "name": "name",
  "segmentsSummary": {
    "linkedSegments": {
      "totalCount": 3,
      "items": [
        {
          "environmentId": "environmentId",
          "name": "name",
          "links": {
            "self": {
              "href": "href",
              "type": "type"
            }
          },
          "key": "key"
        },
        {
          "environmentId": "environmentId",
          "name": "name",
          "links": {
            "self": {
              "href": "href",
              "type": "type"
            }
          },
          "key": "key"
        }
      ]
    },
    "count": 9
  },
  "aiConfigsExpanded": {
    "totalCount": 6,
    "items": [
      {
        "createdAt": 2,
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "name": "name",
        "description": "description",
        "version": 1,
        "key": "key",
        "flagKey": "flagKey",
        "tags": [
          "tags",
          "tags"
        ],
        "updatedAt": 6
      },
      {
        "createdAt": 2,
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "name": "name",
        "description": "description",
        "version": 1,
        "key": "key",
        "flagKey": "flagKey",
        "tags": [
          "tags",
          "tags"
        ],
        "updatedAt": 6
      }
    ]
  },
  "segmentsExpanded": {
    "totalCount": 8,
    "items": [
      {
        "generation": 6,
        "lastModifiedDate": 9,
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "description": "description",
        "creationDate": 5,
        "version": 9,
        "environmentKey": "environmentKey",
        "tags": [
          "tags",
          "tags"
        ],
        "environmentId": "environmentId",
        "deleted": true,
        "name": "name",
        "unbounded": true,
        "key": "key"
      },
      {
        "generation": 6,
        "lastModifiedDate": 9,
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "description": "description",
        "creationDate": 5,
        "version": 9,
        "environmentKey": "environmentKey",
        "tags": [
          "tags",
          "tags"
        ],
        "environmentId": "environmentId",
        "deleted": true,
        "name": "name",
        "unbounded": true,
        "key": "key"
      }
    ]
  },
  "projectId": "projectId",
  "flagsExpanded": {
    "totalCount": 4,
    "items": [
      {
        "archived": true,
        "temporary": true,
        "includeInSnippet": true,
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "name": "name",
        "description": "description",
        "creationDate": 7,
        "_version": 1,
        "key": "key",
        "maintainer": {
          "kind": "member",
          "_member": {
            "firstName": "Ariel",
            "lastName": "Flores",
            "role": "admin",
            "_links": {
              "self": {
                "href": "/api/v2/members/569f183514f4432160000007",
                "type": "application/json"
              }
            },
            "_id": "569f183514f4432160000007",
            "email": "ariel@acme.com"
          },
          "_team": {
            "_links": {
              "key": {
                "href": "href",
                "type": "type"
              }
            },
            "name": "QA Team",
            "customRoleKeys": [
              "access-to-test-projects"
            ],
            "key": "team-key-123abc"
          },
          "key": "key"
        },
        "tags": [
          "tags",
          "tags"
        ]
      },
      {
        "archived": true,
        "temporary": true,
        "includeInSnippet": true,
        "_links": {
          "parent": {
            "href": "href",
            "type": "type"
          },
          "self": {
            "href": "href",
            "type": "type"
          }
        },
        "name": "name",
        "description": "description",
        "creationDate": 7,
        "_version": 1,
        "key": "key",
        "maintainer": {
          "kind": "member",
          "_member": {
            "firstName": "Ariel",
            "lastName": "Flores",
            "role": "admin",
            "_links": {
              "self": {
                "href": "/api/v2/members/569f183514f4432160000007",
                "type": "application/json"
              }
            },
            "_id": "569f183514f4432160000007",
            "email": "ariel@acme.com"
          },
          "_team": {
            "_links": {
              "key": {
                "href": "href",
                "type": "type"
              }
            },
            "name": "QA Team",
            "customRoleKeys": [
              "access-to-test-projects"
            ],
            "key": "team-key-123abc"
          },
          "key": "key"
        },
        "tags": [
          "tags",
          "tags"
        ]
      }
    ]
  }
}