Skip to main content

List saved workspace views

List views visible to the authenticated user for one supported workspace.

GET/api/workspace-views
HTTP referenceScope workspace_views:readUpdated September 27, 2026

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.

Organization-visible views and the caller’s private views are returned. View configuration is workspace-specific; use the relevant workspace field/selection catalog rather than assuming a universal config schema.

Query parameters

  • workspacerequired

    string

    companies, leads, tasks, or signals.

Errors

StatusMeaning
401Authentication is missing or invalid.
403The credential is invalid or lacks the required scope, or the caller cannot access the resource.
400Workspace is unsupported or organization context is missing.

Docs