Allo

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}

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

Body fields

FieldTypeDescription
namestringNew display name, up to 255 characters. Must not be blank when sent
filtersarrayReplaces all the conditions. [] clears them. Up to 50
sortarrayReplaces 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_typestringUSER 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

StatusCodeWhen
400INVALID_REQUEST_BODYname 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)
400INVALID_FILTER_FIELDA 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
400INVALID_FILTER_OPERATORA filter operator does not match the type of its field. The message names the field. param is filters
400INVALID_FILTER_VALUEA 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
400INVALID_SORT_FIELDA sort field is neither a built-in field nor a custom field key from GET /v2/api/crm/attributes. param is sort
400FIELD_NOT_SORTABLEA sort field exists but cannot be sorted on. Use a built-in sortable field or a sortable custom field. param is sort
400USER_HAS_NO_TEAMowner_type is TEAM but you do not belong to a team. Use USER. param is owner_type
403API_KEY_INSUFFICIENT_SCOPEThe key does not hold CRM_WRITE
403VIEW_PERMISSION_DENIEDThe view is a team view and you are neither its owner nor a team ADMIN or MANAGER
404VIEW_NOT_FOUNDNo 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

ISIS_NOTCONTAINSNOT_CONTAINSEMPTYNOT_EMPTYSTARTS_WITHENDS_WITHBEFOREAFTERDATE_EQUALSGREATER_THANGREATER_THAN_OR_EQUALLESS_THANLESS_THAN_OR_EQUALHAS

valuestringrequired

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

ISIS_NOTCONTAINSNOT_CONTAINSEMPTYNOT_EMPTYSTARTS_WITHENDS_WITHBEFOREAFTERDATE_EQUALSGREATER_THANGREATER_THAN_OR_EQUALLESS_THANLESS_THAN_OR_EQUALHAS

valuestringrequired

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.

USERTEAM

user_idstring | null

ID of the user who owns a USER view

team_idstring | null

ID of the team a TEAM view belongs to

created_atstring
updated_atstring
400
401
403
404
429