Create a saved view

Create a saved view to preserve specific UI state configurations for programs, tasks, or requests including column selections, filter criteria, sort orders, and visibility settings. This endpoint enables users to save their personalized grid configurations for quick access, reducing repetitive filtering and column arrangement. When successful, returns a SavedView resource with a unique identifier that can be referenced for subsequent updates or retrievals. For example, create a saved view named 'High Priority Q1 Tasks' scoped to workspace w5PmrE9p0kicqqRSVJ3VBQ with filters for tasks due before March 31 and priority 'High', or create 'My Team Programs' with columns displaying owner, status, and planned end date. Use this endpoint when users explicitly save custom views in the UI or when programmatically creating default workspace views during onboarding. The gridState property captures the complete UI configuration including column widths, filter expressions, and visibility toggles, enabling exact recreation of the user's preferred interface layout.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
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".

Body Params

The saved view data

string

Human-readable display name for the saved view shown in user interface view selectors, dropdowns, and view management screens. Typically 2-50 characters describing the view purpose such as High Priority Tasks, Q4 Marketing Programs, or My Open Requests. User-defined and can be updated after creation. Should be unique within the space for clarity but uniqueness is not enforced. Use descriptive names that clearly convey the filtering, sorting, or grouping applied in the view to help users quickly identify and select the appropriate view configuration.

string
enum

Display mode type indicating whether this saved view uses grid/list layout for tabular data display or timeline/gantt chart visualization for chronological project views. Must be either list for table-based views with rows and columns, or timeline for date-based gantt-style displays. Determines which UI components are rendered and which state properties (gridState vs timelineState) are relevant when loading the view. Use list for filtering, sorting, and analyzing data in table format. Use timeline for visualizing task schedules, program phases, and date-based dependencies.

Allowed:
string
enum

Resource type that this saved view applies to, indicating whether the view filters and displays programs, requests, or tasks. Must be one of programs for program management views, requests for request form submission views, or tasks for task tracking views. Determines the entity type shown when the view is loaded, which API endpoint is called to fetch data, and which properties are available for filtering, sorting, and column display. Each saved view is scoped to exactly one route. Use to organize views by resource type and ensure correct data fetching and UI rendering when the view is activated.

Allowed:
gridState

Array of column configuration objects defining the visible columns, their display order, widths, sort direction, grouping settings, and visibility flags for grid/list view display. Each GridState object in the array represents one column's configuration including the column identifier, sizing behavior (flex or fixed width), hide status, grouping behavior, and sort direction. Optional field that can be null for timeline-only views where grid display is not applicable. Use to persist and restore exact grid layout preferences including which columns are shown, their sequence from left to right, their widths, and any applied sorting or grouping. Pass null when creating timeline views that do not require grid column configuration.

string

ag-Grid filter model object defining active column filters for the saved view. This complex object structure uses column field names as keys, with each value being a filter configuration object specific to that column type. Text filters include filterType and filter value properties, number filters use type (equals, lessThan, greaterThan) with filter value, date filters contain dateFrom and dateTo for range filtering. The structure follows ag-Grid filter model conventions where each key represents a column ID and its value describes the filter criteria applied to that column. Use this to persist user filter preferences such as showing only high priority items, filtering by specific assignees, or limiting results to date ranges. Set to null or omit to create a saved view with no filters applied. Example shows priority column filtered to high value.

timelineState

Timeline/gantt chart display configuration object containing zoom level settings, visible date range boundaries, row height preferences, timeline-specific grouping options, and gantt view display settings. Only applicable and meaningful when type is set to timeline. Optional field that can be null for list-only views where timeline visualization is not used. Use to persist and restore timeline visualization preferences including how much time is displayed per screen width (zoom), what date range is initially visible, how tall each row appears, and any timeline-specific filtering or grouping. Pass null when creating list views that do not require timeline/gantt chart configuration. The TimelineState object structure varies based on specific timeline implementation requirements.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json