Get one saved view

get

https://api.seismic.com/programs/v2/spaces/{spaceId}/savedViews/{savedViewId}

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.

Path Params

spaceId

string

required

length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

savedViewId

string

required

Unique identifier for the specific saved view to retrieve. This is a stable string ID in base64url or GUID format (example sv7YtMp2kQxRvN9LmW4HzAg). Use this ID to fetch a particular saved view configuration including its grid state, filters, sorts, and timeline settings. Obtain this ID from list saved views responses or from previously created saved views. Required for retrieving the exact view configuration to apply to your workspace display.

Responses

Language

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Bad Request

401Authentication failed due to missing, invalid, or expired JWT token. Obtain a valid token with required permission scopes.

403Access denied due to insufficient permissions to access entity or perform the requested action. Contact your administrator for assistance.

404Entity not found. Verify the entity ID exists to ensure proper permissions are granted.

500Internal server error during entity retrieval, mutation, or deletion.