ChatGPT ↗
Claude ↗This page documents the canonical HTTP contract for this endpoint.
Developer API keys need the listed scope. A valid authenticated user session may also call this route.
Saved views are scoped to the authenticated organization and user: organization-visible views and the caller’s private views may be listed, and mutation access is limited to editable views.
The raw view routes also accept workspace=signals. Developer keys use workspace_views:read to list and workspace_views:write to mutate these saved views; authenticated user sessions are also supported. This documents the raw endpoint behavior; the registered crm.saved_views list operation continues to describe Leads and Companies. Signals filter/topic values are preserved instead of receiving legacy CRM field-token rewrites. Shared view normalization still applies; typed filter descriptors and query_sort are supported for Leads views only.
Only views editable by the caller can be updated. The config example is schematic; resolve supported field tokens and filter grammar from the workspace catalogs.
Path parameters
view_idrequiredstring
Saved view identifier.
| Name | Type | Description |
|---|---|---|
| view_idrequired | string | Saved view identifier. |
Body parameters
workspace· optionalstring
companies, leads, tasks, or signals.
name· optionalstring
Non-empty name, truncated to 120 characters.
visibility· optionalstring
private or org; unsupported values normalize to org.
config· optionalobject
Replacement workspace-specific view configuration. When supplying sort, the canonical shape is {field,order}, with order asc|desc; legacy direction is accepted and normalized to order.
| Name | Type | Description |
|---|---|---|
| workspace | string | companies, leads, tasks, or signals. |
| name | string | Non-empty name, truncated to 120 characters. |
| visibility | string | private or org; unsupported values normalize to org. |
| config | object | Replacement workspace-specific view configuration. When supplying sort, the canonical shape is {field,order}, with order asc|desc; legacy direction is accepted and normalized to order. |
Errors
| Status | Meaning |
|---|---|
| 401 | Authentication is missing or invalid. |
| 403 | The credential is invalid or lacks the required scope, or the caller cannot access the resource. |
| 400 | Workspace, name, or configuration is invalid, or organization/user context is missing. |
| 404 | View is missing or not editable by the caller. |