Skip to main content
PATCH
Update contact view
Required scope: CRM_WRITE
This endpoint performs a partial update. Only the fields you send are modified. Send filters: [] to clear the filters.

Body fields

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

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Public ID of the view, as returned by the list endpoint

Example:

"cvw_2abc"

Body

application/json

All fields are optional. An omitted field is unchanged. filters: [] clears the filters.

name
string

New name. Must not be blank when sent

Maximum string length: 255
Pattern: \S
Example:

"Hot leads"

filters
object[]

Conditions combined with AND. At most 50

Maximum array length: 50
sort
object[]

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

Maximum array length: 2
owner_type
enum<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.

Available options:
USER,
TEAM
Example:

"USER"

Response

The updated view

data
object

A saved view: a named filter and sort over people. Views created in the Allo app and with the API are the same objects.