# Update view

> Partially updates a view: only the fields you send change. filters: [] clears the filters. Updating a team view requires being its owner or a team ADMIN or…

`PATCH /v2/api/crm/views/{id}`

<Note>
**Required scope:** `CRM_WRITE`
</Note>

This endpoint performs a partial update. Only the fields you send are modified. Send `filters: []` to clear the filters.

## Body fields

| Field | Type | Description |
|-------|------|-------------|
| `name` | string | New display name, up to 255 characters. Must not be blank when sent |
| `filters` | array | Replaces all the conditions. `[]` clears them. Up to 50 |
| `sort` | array | Replaces the sort. Up to 2 entries. `field` is a sortable built-in field (`name`, `company`, `job_title`, `website`, `created_at`, `updated_at`, `last_activity`) or the `key` of a sortable custom field from [List custom fields](/docs/crm/list-attributes) |
| `owner_type` | string | `USER` or `TEAM` |

```json
{ "name": "Acme leads" }
```

Updating a team view requires being its owner or a team ADMIN or MANAGER.

## Response

Returns `200` with the updated view, in the same shape as [Get view](/docs/crm/get-view).

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `INVALID_REQUEST_BODY` | `name` is blank or longer than 255 characters, `filters` has more than 50 entries, or `owner_type` is not `USER` or `TEAM`. Field-level problems are listed in `errors[]` with the `field` (`name` or `filters`) |
| `400` | `INVALID_FILTER_FIELD` | A filter `field` is neither a built-in person field nor the `key` of a custom field from `GET /v2/api/crm/attributes`. `param` is `filters` |
| `400` | `INVALID_FILTER_OPERATOR` | A filter `operator` does not match the type of its field. The message names the field. `param` is `filters` |
| `400` | `INVALID_FILTER_VALUE` | A filter `value` cannot be read for the type of its field: a number field needs a numeric value, a date field needs an ISO 8601 date such as `2026-01-31` or `2026-01-31T00:00:00Z`. The message names the value and the field. `param` is `filters` |
| `400` | `INVALID_SORT_FIELD` | A sort `field` is neither a built-in field nor a custom field `key` from `GET /v2/api/crm/attributes`. `param` is `sort` |
| `400` | `FIELD_NOT_SORTABLE` | A sort `field` exists but cannot be sorted on. Use a built-in sortable field or a sortable custom field. `param` is `sort` |
| `400` | `USER_HAS_NO_TEAM` | `owner_type` is `TEAM` but you do not belong to a team. Use `USER`. `param` is `owner_type` |
| `403` | `API_KEY_INSUFFICIENT_SCOPE` | The key does not hold `CRM_WRITE` |
| `403` | `VIEW_PERMISSION_DENIED` | The view is a team view and you are neither its owner nor a team ADMIN or MANAGER |
| `404` | `VIEW_NOT_FOUND` | No view with this ID, or you cannot see it (for example another user's private view) |
