> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowengineering.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a shared saved view > Requires Admin access. Changes only the fields you send and keeps the rest of the view, including its display options. `relationships`, `columns`, `filters` and `sort` each replace that whole part of the view; null clears columns, filters or sort. ## OpenAPI ````yaml /openapi/customer-api.json patch /project/{projectId}/views/saved/{viewId} openapi: 3.0.0 info: contact: {} description: >- Flow customer API reference. Start with the [quickstart](/api/quickstart) and [authentication guide](/api/authentication). title: Customer API version: 1.0.0 servers: - description: Flow API url: '{baseUrl}' variables: baseUrl: default: https://backend.branch.flowengineering.com security: [] tags: - name: Audit - name: Automations - name: Branches - name: Comments - name: Convert - name: Data Model - name: Diagrams - name: Entities - name: Events - name: Files - name: Import - name: Notifications - name: Persistent agents - name: Projects - name: ReqIF - name: ReqIF Import - name: Review policy - name: Shared Access Grants - name: User Groups - name: Users - name: Views paths: /project/{projectId}/views/saved/{viewId}: patch: tags: - Views summary: Update a shared saved view description: >- Requires Admin access. Changes only the fields you send and keeps the rest of the view, including its display options. `relationships`, `columns`, `filters` and `sort` each replace that whole part of the view; null clears columns, filters or sort. operationId: ViewsController_updateSavedView parameters: - in: path name: projectId required: true schema: type: string - in: path name: viewId required: true schema: type: string - description: Workspace identifier in: header name: customer required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateSharedSavedViewDto' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/SharedSavedViewDto' description: '' security: - api-key: [] - bearer: [] components: schemas: UpdateSharedSavedViewDto: properties: columns: description: >- Table columns, in order. Replaces every column; [] leaves the view on the default columns. Stored as `state.columns`. null clears them too. items: $ref: '#/components/schemas/SavedViewColumnDto' nullable: true type: array filters: allOf: - properties: nodes: items: anyOf: - additionalProperties: false properties: id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string kind: enum: - group type: string nodes: description: The same leaves as the top level; groups may nest. items: {} type: array operator: enum: - and - or type: string required: - kind - operator - nodes type: object - anyOf: - additionalProperties: false properties: fieldId: type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: description: >- Value-agnostic presence check; supply no value operand. enum: - isPopulated - isEmpty type: string type: enum: - tag - stage - verificationResult - text - richText - number - date - user type: string required: - type - fieldId - operation type: object - additionalProperties: false properties: fieldId: type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - overlaps - excludes type: string tags: items: type: string type: array type: enum: - tag - stage - verificationResult type: string required: - type - fieldId - operation - tags type: object - additionalProperties: false properties: fieldId: type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - equals - notEquals - contains - notContains - startsWith - endsWith type: string text: type: string type: enum: - text - richText type: string required: - type - fieldId - operation - text type: object - additionalProperties: false properties: fieldId: type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - equals - notEquals - greaterThan - greaterThanOrEqual - lessThan - lessThanOrEqual - between type: string type: enum: - number type: string value: type: string valueTo: type: string required: - type - fieldId - operation - value type: object - additionalProperties: false properties: date: nullable: true type: string dateTo: nullable: true type: string fieldId: type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - 'on' - before - after - between type: string type: enum: - date type: string required: - type - fieldId - operation - date type: object - additionalProperties: false properties: date: nullable: true type: string dateTo: nullable: true type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - 'on' - before - after - between - within - notWithin type: string range: description: >- For within / notWithin: the rolling window ending now — the last 24 hours, 7, 30 or 90 days. enum: - day - week - month - quarter nullable: true type: string timestamp: description: >- Which lifecycle instant to compare: when the item was created, or when it last changed (any field or link edit visible on this branch). enum: - createdAt - updatedAt type: string type: enum: - timestamp type: string required: - type - timestamp - operation - date type: object - additionalProperties: false properties: fieldId: type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - isTrue - isFalse type: string type: enum: - toggle type: string required: - type - fieldId - operation type: object - additionalProperties: false properties: fieldId: type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - overlaps - excludes type: string type: enum: - user type: string userIds: items: type: string type: array required: - type - fieldId - operation - userIds type: object - additionalProperties: false properties: id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - overlaps - excludes type: string type: enum: - type type: string typeIds: items: type: string type: array required: - type - operation - typeIds type: object - additionalProperties: false properties: fieldId: type: string fieldType: enum: - jira - teamcenter - linear - googleDoc - googleSheet - aodocsDoc - file - cadFile type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - isPopulated - isEmpty type: string type: enum: - presence type: string required: - type - fieldId - fieldType - operation type: object - additionalProperties: false properties: id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - overlaps - excludes type: string type: enum: - changedInBranch type: string required: - type - operation type: object - additionalProperties: false properties: id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - isPopulated - isEmpty type: string resolved: enum: - open - resolved type: string type: enum: - hasComments type: string required: - type - operation type: object - additionalProperties: false properties: id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - overlaps - excludes type: string resolved: enum: - open - resolved type: string type: enum: - commentBy type: string userIds: items: type: string type: array required: - type - operation - userIds type: object - additionalProperties: false properties: id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - contains - notContains type: string resolved: enum: - open - resolved type: string text: maxLength: 1000 type: string type: enum: - commentText type: string required: - type - operation - text type: object - additionalProperties: false properties: fieldId: nullable: true type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - overlaps - excludes type: string resolved: enum: - open - resolved type: string type: enum: - commentField type: string required: - type - operation - fieldId type: object - additionalProperties: false properties: id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - matches type: string text: type: string type: enum: - search type: string required: - type - operation - text type: object - additionalProperties: false properties: direction: description: >- Which links count: `upstream` (inbound), `downstream` (outbound), `up+downstream`, or `cross-link`. Omit to count a link of any kind — inbound, outbound and cross-link alike — which is also what the view toolbar does with no direction set. enum: - upstream - downstream - up+downstream - cross-link type: string entityId: default: null nullable: true type: string id: description: >- Any string unique within the expression; Flow assigns one when omitted. minLength: 1 type: string operation: enum: - overlaps - excludes type: string targetKind: description: >- Whether the target is one entity (`entityId`) or any entity of a type (`typeId`). Inferred from which id is given when omitted. enum: - entity - type type: string type: enum: - linkedTo type: string typeId: default: null description: >- Entity-type reference for "linked to any entity of this type"; use the category form required by the calling tool. nullable: true type: string required: - type - operation type: object type: array operator: enum: - and - or type: string required: - operator - nodes type: object description: >- Conditions every item the view shows must meet, joined by `operator`; a `group` node joins its own `nodes` with its own operator. Each leaf's `type` is the FIELD'S DATA TYPE (`tag`, `stage`, `verificationResult`, `text`, `richText`, `number`, `date`, `toggle`, `user`, `presence`) with `fieldId` a field key from the categories endpoint (or `::`), or a structural condition (`type`, `linkedTo`, `timestamp`, `changedInBranch`, the comment conditions). Tag, stage and verification values are option NAMES; user values are user ids; type ids are data type ids. Unknown fields, options, types or operations answer 400 and nothing is saved. Example — Status is Triage: {"operator":"and","nodes":[{"type":"tag","fieldId":"status","operation":"overlaps","tags":["Triage"]}]}. Stored as `state.filters`. null clears them. nullable: true icon: allOf: - $ref: '#/components/schemas/SavedViewIconDto' description: null removes the icon. nullable: true type: object name: type: string relationships: description: >- Nesting rules, in order: under each `parentType`, show items of `childType`. Replaces every rule; send [] to remove them all. Stored as `state.relationships`. items: $ref: '#/components/schemas/SavedViewRelationshipDto' type: array rootType: description: >- Data type id of the items the view starts from (its "Start type"). Stored as `state.rootType`. null clears it. nullable: true type: object sort: description: >- Ordered sort keys, the first most significant. Replaces the whole sort; send [] for the natural order. Stored as `state.sort`. null clears it. items: $ref: '#/components/schemas/SavedViewSortDto' nullable: true type: array type: object SharedSavedViewDto: properties: icon: $ref: '#/components/schemas/SavedViewIconDto' id: type: string name: type: string position: description: Display order among the shared views. type: number state: additionalProperties: true description: >- The view configuration: `rootType`, `relationships`, `columns`, `filters` and `sort` as written here, plus display options edited in Flow. type: object required: - id - name type: object SavedViewColumnDto: properties: categories: description: >- Field columns only: the data type ids the column applies to. Omitted or empty, it applies to every type that carries the field. A `link` column takes none. items: type: string type: array key: description: >- Field key of the column: a key from the categories endpoint (`name`, `description`, `owner`, `reviewers`, `unique_entity_number` or a custom field key), `::` to pin one type's field, or a reserved key: `__createdAt` (Created), `__updatedAt` (Updated), `__entityType` (Type), `__hierarchyDepth` or `__itemLink`. Give exactly one of `key` and `link`. type: string link: allOf: - $ref: '#/components/schemas/SavedViewLinkColumnDto' description: A linked-items column instead of a field column. pinned: description: Keep the column pinned on the left of the table. type: boolean wrap: description: Wrap cell text onto several lines. type: boolean type: object SavedViewIconDto: properties: colour: description: Icon color, as data types use. type: string icon: description: Icon name, as data types use. type: string required: - icon - colour type: object SavedViewRelationshipDto: properties: childType: description: Data type id of the items shown under each parent. type: string direction: description: >- Which links the view follows from parent to child: `downstream` (the parent links to the child), `upstream` (the child links to the parent) or `both`. Defaults to `both`. enum: - upstream - downstream - both type: string parentType: description: Data type id of the parent. type: string required: - parentType - childType type: object SavedViewSortDto: properties: columnId: description: >- A column key as in `columns`: a field key or `::` ref; a reserved key (`name`, `__createdAt`, `__updatedAt`, `__entityType`, `__hierarchyDepth`). A linked-items column cannot be sorted by. type: string direction: enum: - asc - desc type: string required: - columnId - direction type: object SavedViewLinkColumnDto: properties: direction: description: >- Which links the column follows from the row: `downstream` (the row links to the item), `upstream` (the item links to the row), `up+downstream` or `cross-link`. enum: - up+downstream - cross-link - upstream - downstream type: string entityType: description: Data type id of the linked items the column lists. type: string required: - entityType - direction type: object securitySchemes: api-key: in: header name: X-API-Key type: apiKey bearer: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.