--- title: "ListUISavedViews" method: GET path: "/v1/namespaces/{tenant_meta.namespace}/ui-saved-views" tags: ["UISavedViewService"] --- # ListUISavedViews `GET /v1/namespaces/{tenant_meta.namespace}/ui-saved-views` ## Request - Base URL: `https://api.endorlabs.com` - URL: `https://api.endorlabs.com/v1/namespaces/{tenant_meta.namespace}/ui-saved-views` - Auth: none declared Lists all saved views in a namespace. ## Path parameters - `tenant_meta.namespace` string, required ## Query parameters - `list_parameters.filter` string - `list_parameters.page_token` integer - `list_parameters.page_size` integer - `list_parameters.action` string - `list_parameters.mask` string - `list_parameters.traverse` boolean - `list_parameters.sort.path` string - `list_parameters.sort.order` 'SORT_ENTRY_ORDER_UNSPECIFIED' | 'SORT_ENTRY_ORDER_ASC' | 'SORT_ENTRY_ORDER_DESC' - `list_parameters.count` boolean - `list_parameters.group.aggregation_paths` string - `list_parameters.group.show_aggregation_uuids` boolean - `list_parameters.group.unique_count_paths` string - `list_parameters.group.unique_value_paths` string - `list_parameters.ci_run_uuid` string - `list_parameters.page_id` string - `list_parameters.group_by_time.aggregation_paths` string - `list_parameters.group_by_time.show_aggregation_uuids` boolean - `list_parameters.group_by_time.interval` 'GROUP_BY_TIME_INTERVAL_UNSPECIFIED' | 'GROUP_BY_TIME_INTERVAL_YEAR' | 'GROUP_BY_TIME_INTERVAL_QUARTER' | 'GROUP_BY_TIME_INTERVAL_MONTH' | 'GROUP_BY_TIME_INTERVAL_WEEK' | 'GROUP_BY_TIME_INTERVAL_DAY' | 'GROUP_BY_TIME_INTERVAL_HOUR' | 'GROUP_BY_TIME_INTERVAL_MINUTE' | 'GROUP_BY_TIME_INTERVAL_SECOND' - `list_parameters.group_by_time.group_size` integer - `list_parameters.group_by_time.start_time` string, date-time - `list_parameters.group_by_time.end_time` string, date-time - `list_parameters.group_by_time.mode` string - `list_parameters.group_by_time.aggregation_value_field` string - `list_parameters.group_by_time.aggregation_operator` string - `list_parameters.disable_pagination` boolean ## Response `200` A successful response. - V1ListUISavedViewsResponse: Response to the request to list UI saved views. - `count_response` V1CountResponse: Response to a list count request. - `count` integer: Number of objects matching the given list parameters. - `group_response` V1GroupResponse: Response to a list group request. - `groups` object: Map indexed by values of the fields specified in aggregation_paths, for example, {"[{"key":"meta.kind","value":"Project"}]": { "aggregation_count": { "count": 1649 } } }. - `list` V1ListUISavedViewsResponseList: List wraps a page of UISavedView objects with the standard list response. - `objects` V1UISavedView[]: The saved views returned in this page. - `meta` V1Meta, required: Common fields for all Endor Labs resources. - `annotations` object: Annotations can be used to attach metadata to a resource message. Annotation values can be small or large, structured or unstructured, and may include characters not permitted by labels. The keys may contain alphanumerics, underscores (_), dots (.) and dashes (-). The values of an annotation must be 16384 bytes or smaller. - `create_time` string, date-time: Time the resource was created. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt. - `created_by` string: Name and authentication source of the user who created the object, for example, ewok@endor.ai@google@api-key. - `description` string: Resource description. Must be less than 1024 bytes. - `index_data` V1IndexData: IndexData is used to index the resource for search. It's an internal object. - `data` string[] - `search_score` number, float: search_score is the score of the resource for search. Internal use only. - `tenant` string - `will_be_deleted_at` string, date-time: Time that the resource will be deleted. - `kind` string: Resource kind, for example, HelloResponse. Auto-generated using the protobuf message proto.MessageName().Name(). - `name` string, required: Resource name. Must be 63 characters or less. - `parent_kind` string: Parent object resource kind, for example, Project. - `parent_uuid` string: Parent object UUID. - `references` object: Map of objects referenced in a query API. - `tags` string[]: List of tags attached to the resource. Tags can be used to select objects and to find collections of objects that satisfy certain conditions. A tag must be 255 characters or less. - `update_time` string, date-time: Time the resource was last updated. Note: Updated on all create/patch/delete operations. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt. - `updated_by` string: Name and authentication source of the last user who updated the object, for example, vulnerabilityingestor@endor.ai@x509. - `upsert_time` string, date-time: Time the resource was last upserted. Note: create_time is only set the first time the resource is created. upsert_time is set every time the resource is upseted. Format: 2017-01-15T01:30:15.01Z RFC 3339: https://www.ietf.org/rfc/rfc3339.txt. - `version` string: Message version. - `propagate` boolean: Propagate controls the visibility of the saved view in child namespaces. - `spec` V1UISavedViewSpec, required: Spec captures the saved view's configuration. - `display` object: Free-form display configuration (column order, widths, sort, grouping, etc.). Shape is owned by the frontend and versioned via display_version. - `display_version` integer: Schema version of the display payload. Allows the frontend to migrate older display blobs when the shape evolves. - `owner_claims` string[] - `query` QueryQuerySpec, required - `kind` string, required: The parent object kind of the metric. - `list_parameters` V1ListParameters: Parameters for a list request. - `action` string: Action to be executed with a request. Not supported for all endpoints. - `ci_run_uuid` string: Only return objects from PR scans that match this context id. - `count` boolean: Return the number of objects matching the given list parameters. If count is set to true, the response is a CountResponse. Can be used together with filter and traverse. - `disable_pagination` boolean: If true, the results will not be paginated and only the first page will be returned. The order of the results is not guaranteed. - `filter` string: String of conditions to filter resources by. Filters may include any attribute along with the following operators: "==", "!=", ">", ">=", "<", "<=", "Contains", "In", "Matches", and "Exists". The logical operators "And" and "Or" are also supported. Expressions may be combined and grouped with parentheses. Examples: "spec.value == 5", "spec.value in ["a", "b", "c"]", "(meta.name == "xyz" and "spec.value in ["a","b"]) or (spec.value == "c")". - `group` ListParametersGroup: Contains the group parameters. - … - `group_by_time` ListParametersGroupByTime: Contains the group_by_time parameters. - … - `mask` string: List of fields to return (all fields are returned by default). - `page_id` string: Page ID to retrieve. - `page_size` integer: Set the page size to limit the number of results returned. Default: 100. Max: 500. - `page_token` integer: Set the page token to start from. Use page tokens to page through list results or list specific pages. - `search_query` V1SearchQuery: SearchQuery is the top level message for search queries. - … - `sort` ListParametersSortEntry: Contains the sort parameters. - … - `traverse` boolean: Get data from any child namespaces as well. - `references` V1QueryReference[] - `connect_from` string: The parent field from which we are connecting. If emtpy, it is UUID. - `connect_operator` string: The operation that should be used to connect parent and child. If empty it is the equal operator. Only supporting scalar value operators at this time. - `connect_to` string: The child field to connect to. If empty, it is parent_uuid. - `query_spec` QueryQuerySpec (recursive) - `return_as` string: Determines the alias name for reference that should be returned. If not specified, the value of kind is used. This field can be used to query a same kind several times. For instance, you can use this field to list and do a count on a same kind. - `with` QueryJoinFilters[]: A list of join filters that identify the kind + filter of the other collections that should be joined. For example, if we are looking for projects that are also have repositories with specific attributes, we can use "with" : [{ "Kind" : "Repository", "Filter" : "filter for the repository", }] With is only available for the PackageVersion and Project resource kinds at this time. - `filter` string - `kind` string, required - `scope` 'SCOPE_UNSPECIFIED' | 'SCOPE_PERSONAL' | 'SCOPE_NAMESPACE', required: Who owns / can see the view. Determines lookup precedence and sharing. - SCOPE_UNSPECIFIED: No scope has been set. - SCOPE_PERSONAL: Visible only to the user who created the view. - SCOPE_NAMESPACE: Shared with everyone in the owning namespace. - `surface` string, required: Surface identifier that scopes the view to a specific UI area, e.g. "findings.table" or "packages.inventory". Lowercase, dot-separated segments of [a-z0-9_]. - `view_type` 'VIEW_TYPE_UNSPECIFIED' | 'VIEW_TYPE_TABLE', required: The UI presentation flavor of the view. - VIEW_TYPE_UNSPECIFIED: No view type has been set. - VIEW_TYPE_TABLE: Tabular (columns + rows) presentation. - `tenant_meta` V1TenantMeta, required: Tenant related data for the tenant containing the resource. - `namespace` string, required: Namespaces are a way to organize organizational units into virtual groupings of resources. Namespaces must be a fully qualified name, for example, the child namespace of namespace "endor.prod" called "app" is called "endor.prod.app". - `uuid` string: The UUID of the saved view. - `response` V1ListResponse: Response to a list request. - `next_page_id` string: The UUID of last message retrieved. - `next_page_token` integer: Pagination token that can be used to retrieve the next page of results. ## Other responses - `default`: An unexpected error response. ## Changes - **2026-11-03** `4acd9fe15140`: 1 info - endpoint added [Operation history](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference/changes/v1/namespaces/:tenant_meta.namespace/ui-saved-views/get.md) --- [API](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference.md) - [All operations](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference/revisions/4acd9fe15140?raw)