Get saved views

Retrieves a paginated list of saved view configurations within a specified space, returning all user-created and system-defined views that match the optional filter criteria. Saved views encapsulate complete workspace UI state including grid column layouts, filter configurations, sort preferences, and timeline display settings, enabling users to quickly switch between different data visualization perspectives. This endpoint is essential for populating view selector dropdowns, implementing view management interfaces, displaying available workspace configurations, and enabling view discovery features. Use this to fetch all available saved views when initializing a workspace, to build view selection menus showing users their custom views alongside default system views, or to implement view management panels where users can browse and select from their collection of saved configurations. The response includes view metadata (name, type, route, creator) and can be filtered by view type (list vs timeline), route context (programs, requests, tasks), or name substring for search functionality. Supports cursor-based pagination for efficient handling of large view collections and sorting by creation or update timestamps.

Key Features:

• Paginated retrieval of all saved views in a space with cursor-based navigation
• Filter by view type (list/timeline), route (programs/requests/tasks), or name substring
• Sort results by createdAt or updatedAt timestamps in ascending or descending order
• Returns both user-created custom views and system-provided default views
• Includes complete view metadata for building view selector interfaces

Typical Use Cases:

1. Populate View Selector Dropdown: Call GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/savedViews?route=tasks&type=list to fetch all list-type task views for displaying in a workspace view selector menu.
2. View Management Interface: Call GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/savedViews?sort=updatedAt:desc&limit=20 to display the 20 most recently modified views in a view management panel where users can browse, edit, or delete their saved configurations.
3. View Search: Call GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/savedViews?name=Priority to find all views with Priority in their name, enabling users to quickly locate specific saved configurations.

Expected Response:
Returns 200 OK with SavedViewQueryResponse containing items array of SavedView objects, pagination metadata (cursor, limit, count), and meta information. Each SavedView includes id, name, type, route, spaceId, gridState, gridFilterModel, gridSortModel, timelineState, createdAt, updatedAt, and creator details.

Authorization Logic:

1. User must have valid JWT token with view or manage scopes
2. Private views are only visible to their creators; shared views visible to all space members
3. System-provided default views are visible to all users with space access