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}
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
owner_type
string
USER or TEAM
{"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.
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)
Authorization
Authorizationstring · headerrequired
Api-Key ak_live_…
Path parameters
idstringrequired
Public ID of the view, as returned by the list endpoint
Body
namestring
New name. Must not be blank when sent
filtersobject[]
Conditions combined with AND. At most 50
3 fields
fieldstringrequired
A built-in person field (name, company, job_title, emails, phone_numbers, website, addresses, created_at, updated_at, last_activity, activity_history, sms_content (only when the team has SMS)) or the key of a custom field from GET /v2/api/crm/attributes. An unknown field returns 400 INVALID_FILTER_FIELD
operatorenum<string>required
Comparison operator. It must match the type of the field, otherwise the request returns 400 INVALID_FILTER_OPERATOR
Value to compare to. It must be readable for the type of the field, otherwise the request returns 400 INVALID_FILTER_VALUE: numeric for a number field, an ISO 8601 date such as 2026-01-31 or date-time such as 2026-01-31T00:00:00Z for a date field. Ignored for EMPTY and NOT_EMPTY
sortobject[]
Up to 2 entries. Sortable built-in fields: name, company, job_title, website, created_at, updated_at, last_activity. A sortable custom field key from GET /v2/api/crm/attributes also works
2 fields
fieldstringrequired
A sortable built-in person field (name, company, job_title, website, created_at, updated_at, last_activity) or the key of a sortable custom field from GET /v2/api/crm/attributes
orderenum<string>required
ascdesc
owner_typeenum<string>
USER is private to the API key's user. TEAM is shared with the user's team; it returns 400 USER_HAS_NO_TEAM when the user has no team.
USERTEAM
Responses
200The updated view
dataobject
A saved view: a named filter and sort over people. Views created in the Allo app and with the API are the same objects.
9 fields
idstring
Public ID of the view
namestring
filtersobject[]
3 fields
fieldstringrequired
A built-in person field (name, company, job_title, emails, phone_numbers, website, addresses, created_at, updated_at, last_activity, activity_history, sms_content (only when the team has SMS)) or the key of a custom field from GET /v2/api/crm/attributes. An unknown field returns 400 INVALID_FILTER_FIELD
operatorenum<string>required
Comparison operator. It must match the type of the field, otherwise the request returns 400 INVALID_FILTER_OPERATOR
Value to compare to. It must be readable for the type of the field, otherwise the request returns 400 INVALID_FILTER_VALUE: numeric for a number field, an ISO 8601 date such as 2026-01-31 or date-time such as 2026-01-31T00:00:00Z for a date field. Ignored for EMPTY and NOT_EMPTY
sortobject[]
2 fields
fieldstringrequired
A sortable built-in person field (name, company, job_title, website, created_at, updated_at, last_activity) or the key of a sortable custom field from GET /v2/api/crm/attributes
orderenum<string>required
ascdesc
owner_typeenum<string>
USER is private to the API key's user. TEAM is shared with the user's team.