Retrieves a single saved view configuration by its unique identifier, returning the complete view definition including grid state, filter configurations, column layouts, timeline settings, and sorting preferences. This endpoint is essential for restoring user-customized workspace views, displaying previously saved filter combinations, and enabling seamless view switching in client applications. Use this when loading a specific saved view to apply its configuration to the current workspace display, such as when a user selects a named view from a dropdown menu or when implementing view-sharing features across team members. The returned SavedView object contains all necessary state to reconstruct the exact grid, filter, and timeline configuration that was saved, enabling consistent data visualization across sessions. For example, call this endpoint when a user clicks on 'My Active Tasks View' to retrieve and apply that view's filters and column arrangement, or when implementing a feature that restores the last-used view on application startup.
Key Features:
- Retrieves complete saved view configuration including all UI state (grid columns, filters, sorts, timeline)
- Returns view metadata (name, type, route, owner) and full state objects for reconstruction
- Supports both system-provided and user-created custom views
- Enables view sharing and collaboration by allowing team members to load shared view configurations
Authorization Logic:
- User must have view or manage permissions for the space containing the saved view
- Private views are only accessible to their creator; shared/public views accessible to all space members
- Returns 404 if view does not exist or user lacks access permissions
Usage Example:
When building a view selector dropdown in your UI, call this endpoint when user selects 'High Priority Tasks' view. Use the returned gridState to configure column visibility and widths, gridFilterModel to apply the saved filters (e.g., priority equals High), and gridSortModel to establish sort order. Apply these configurations to your data grid component to instantly recreate the saved view experience.