# update_view (/docs/reference/mcp-tools/update_view)



{/* Generated by apps/docs/scripts/generate-mcp-pages.mjs — do not edit by hand. */}

Update a saved view (name / scope / filters / sort / grouping / layout).

|                     |                |
| ------------------- | -------------- |
| Required permission | `work:write`   |
| Capability ID       | `views.update` |
| Destructive         | No             |

## Parameters [#parameters]

| Parameter  | Type                   | Required | Notes |
| ---------- | ---------------------- | -------- | ----- |
| `name`     | string                 | no       |       |
| `kind`     | `BOARD` \| `LIST`      | no       |       |
| `scope`    | `PERSONAL` \| `SHARED` | no       |       |
| `filters`  | object                 | no       |       |
| `grouping` | object \| null         | no       |       |
| `sort`     | array of object        | no       |       |
| `layout`   | object \| null         | no       |       |
| `id`       | string (uuid)          | yes      |       |

## Input schema (JSON Schema) [#input-schema-json-schema]

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "kind": {
      "type": "string",
      "enum": [
        "BOARD",
        "LIST"
      ]
    },
    "scope": {
      "type": "string",
      "enum": [
        "PERSONAL",
        "SHARED"
      ]
    },
    "filters": {
      "type": "object",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          },
          {
            "type": "array",
            "items": {
              "description": "recursive — same shape as the parent node"
            }
          },
          {
            "type": "object",
            "additionalProperties": {
              "description": "recursive — same shape as the parent node"
            }
          }
        ]
      }
    },
    "grouping": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              },
              {
                "type": "null"
              },
              {
                "type": "array",
                "items": {
                  "description": "recursive — same shape as the parent node"
                }
              },
              {
                "type": "object",
                "additionalProperties": {
                  "description": "recursive — same shape as the parent node"
                }
              }
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "sort": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            },
            {
              "type": "null"
            },
            {
              "type": "array",
              "items": {
                "description": "recursive — same shape as the parent node"
              }
            },
            {
              "type": "object",
              "additionalProperties": {
                "description": "recursive — same shape as the parent node"
              }
            }
          ]
        }
      }
    },
    "layout": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              },
              {
                "type": "null"
              },
              {
                "type": "array",
                "items": {
                  "description": "recursive — same shape as the parent node"
                }
              },
              {
                "type": "object",
                "additionalProperties": {
                  "description": "recursive — same shape as the parent node"
                }
              }
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}
```

## Access control [#access-control]

A call succeeds only when the personal access token's scopes **and** the holder's role both allow `work:write` (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.