RestApiCategories.visualInvestigator.desc

visual_investigator

2026.04

The SAS Visual Investigator Search and Discovery API provides access to real-time exploration and visualization of the data in SAS Visual Investigator.

Search And Discovery

2025.09

2025.03

2026.01

2026.02

2026.03

2024.09

2024.03

Viya_35

The VI Search and Discovery API provides access to real-time exploration and visualization of the data in Visual Investigator.

Determines the most appropriate way to visualize the results for a given natural language query. The response can be included in the request to /assistedSearches.

An example of a request for /assistedSearches/visualizationTypes. In this example, the user is looking for the most appropriate way to visualize the results of the given natural language query.

The request to /assistedSearches/VisualizationType when determining the appropriate type of visualization for a natural language query.

assistedSearchVisualizationTypeRequest

An example of the response from /assistedSearches/visualizationTypes. In this example, the response includes the most appropriate way to visualize the results of the natural language search query.

The response from /assistedSearches/visualizationType containing the visualization type to use in the request to /assistedSearches.

assistedSearchVisualizationTypeResponse

error2

The request is malformed or contains invalid parameter values.

An example URL including the base path for this API.

Determine the appropriate type of visualization for a natural language query

The response from /analytics/{jobId}/categories containing the categories of text analytics results that are available at a given exploration level.

analyticsCategories

The optional list of terms, phrases, topics, and entities to exclude from the analytics results keyed by category.

analyticsExcludesMap

The exploration level within the text analytics results.

analyticsExplorationLevel

The request to /analytics/{jobId}/results and /analytics/{jobId}/categories to retrieve the text analytics results and categories of result, respectively at a given exploration level.

analyticsExplore

The response from /analytics/{jobId}/identities containing the identities for the person, organization, and location entities that were resolved by the text analytics job.

analyticsIdentities

The identities keyed by category (person, organization, or location). Resolved entity results matching any of the aliases are grouped under the respective identity name.

analyticsIdentitiesMap

The identity for a person, organization, or location entity that was resolved by the text analytics job.

analyticsIdentity

An alias for a person, organization, or location entity that was resolved by the text analytics job.

analyticsIdentityAlias

The response from /analytics and /analytics/{jobId} containing the identifier, state, and parameters of a scheduled text analytics job. The job analyses unstructured text in the matching search results to extract significant terms, phrases, and topics as well as resolve named person, organization and location entities.

analyticsJob

A locale that is supported for text analytics. It is returned in a collection from /analytics/locales.

analyticsLocale

A collection of analytics locale representations.

analyticsLocaleCollection

The request to /analytics to initiate a new text analytics job. The job analyses unstructured text in the matching search results to extract significant terms, phrases, and topics as well as resolve named person, organization, and location entities.

analyticsRequest

analyticsResult

The response from /analytics/{jobId}/results containing the text analytics results that are available at a given exploration level

analyticsResults

The response from /analytics/{jobId}/sankeyDiagrams containing a Sankey diagram generated from the text analytics results at the specified exploration level.

analyticsSankeyDiagram

The request to /analytics/{jobId}/sankeyDiagrams to generate a Sankey diagram from the text analytics results at the specified exploration level.

analyticsSankeyDiagramRequest

analyticsSankeyLink

analyticsSankeyNode

A supported analyzer for analyzing text at index or search time. Returned in a collection from /admin/config/analyzers.

analyzer

analyzerCollection

The list of links to top-level resources and operations available from the root of the API.

The request to /assistedSearches when generating a search request based on a natural language query.

assistedSearchRequest

The response from /assistedSearches containing the generated request body to be used for /searches or /paths.

assistedSearchResponse

This is a base schema used to define paginated collections of resources. This base schema is extended by other schemas in APIs by adding an `items` array property. These extensions define the application/vnd.sas.collection media type (version 2).

baseCollection2

An edge within the context of a request to /centrality for calculating centrality metrics for the objects on a network.

centralityEdge

The different centrality values for an object on the network.

centralityMetrics

The response from /centrality representing the centrality metrics for the objects on a network.

centralityMetricsCollection

The request to /centrality for calculating the centrality metrics for the objects on a network. The network is represented by a collection of edges, that is, the relationships between the objects.

centralityNetwork

The part of the response from /highlighting that captures highlighting snippets for a single child object.

childObjectHighlighting

The part of the response from /highlighting that groups highlighting snippets by child object type.

childObjectTypeHighlighting

The part of the request to /highlighting that specifies the paging parameters for each child object type.

childObjectTypeHighlightingParameters

The request and response for /admin/config when importing and exporting object and relationship types between systems.

configuration

An edge within the context of the Network visualization. An edge represents a relationship between two internal or external objects, or between a resolved object and one of its contributing objects. Note the fields property is returned only from /graphs/edges.

edge

edgeCollection

The identifier for a vertex on one end of an edge.

endpoint

An event within the context of the Map and Time Line visualizations

event

The different filter types that can be applied to narrow or drill down into the search results. See specific filter definitions for more details.

filter

This filter combines two or more filter objects using a Boolean AND operation thereby creating the intersection of their individual search results

filterTypeAnd

Filters objects based on geo data in the form of events. Objects containing a geo event whose location intersects with the specified bounded box are included in the search results.

filterTypeBox

Filters objects by values in date fields. Objects containing a date value in the specified field within the given range are included in the search results.

filterTypeDateRange

This filter applies the Boolean NOT operation to another filter thereby producing the opposite search results of the contained filter.

filterTypeNot

This filter combines two or more filter objects using a Boolean OR operation thereby creating the union of their individual search results

filterTypeOr

Filters objects based on geo data in the form of events. Objects containing a geo event whose location intersects with the specified polygon are included in the search results.

filterTypePolygon

Filters objects based on the given query. Objects matching the query is included in the search results.

filterTypeQuery

Filters objects based on geo data in the form of events. Objects containing a geo event whose location intersects with the specified circle are included in the search results.

filterTypeRadius

Filters objects by values in numerical fields. Objects containing a numerical value in the specified field within the given range are included in the search results.

filterTypeRange

Filters objects based on geo data in the form of events. Objects containing a geo event whose location relates to the specified GeoJSON shape are included in the search results.

filterTypeShape

Filters objects by values in text fields. Only objects containing an exact match for one of the specified terms in the specified field are included in the search results.

filterTypeTerms

Filters objects by their type. Objects of the named types are included in the search results.

filterTypeType

A GeoJSON feature in the context of the Map visualization

geoJsonFeature

The GeoJSON feature collection returned as part of the Map visualization when the results are not clustered.

geoJsonFeatureCollection

The details about the events at this map location.

geoJsonFeatureProperties

A GeoJSON shape for use in the shape filter.

geoJsonShape

A collection of GeoJSON shape representations.

geoJsonShapeCollection

The response from /graphs and /traversals in relation to the Network visualization. In the network, objects are represented by vertices and the relationships between them are represented by edges.

graph

The total number of vertices and edges in the graph

graphCounts

The request to /graphs for obtaining the Network visualization. In the network, objects are represented by vertices and the relationships between them are represented by edges.

graphRequest

The response from /highlighting containing highlighting snippets for a single object based on a given query.

highlighting

The request to /highlighting for generating highlighting snippets for a single object based on a given query

highlightingRequest

The response from /admin/indices/{type} when requesting information about the index for a single object or relationship type

index

indexCollection

The response from /admin/indices/version requesting the index format version this service supports.

indexFormatUpgradeResponse

An indicator icon for an object type style.

indicatorIcon

A link to a related operation or resource.

link

maskedFieldConfiguration

The identifier of a single object used in many of the requests and responses.

objectIdentifier

Describes the fields to retrieve for a given object type.

objectTypeFields

A collection of properties that determine the style for an object type

objectTypeStyle

The request to /admin/operations to perform an administration-related operation

operationRequest

The parameters for the make index searchable operation.

operationRequestParametersForMakeIndexSearchable

The parameters for the refresh configuration operation

operationRequestParametersForRefreshConfiguration

The response from a request to /admin/operations to perform an administration-related operation.

operationResponse

A path within the context of the Network visualization. A path is a finite sequence of relationships (edges) connecting a sequence of objects (vertices) in the Network visualization.

path

pathCollection

The request to /paths when searching for matching paths from one or more start objects. Use the type and id properties to identify a single start object, or use the types and query properties to identify one or more start objects.

pathsRequest

The criteria for the next level of the path search.

pathsRequestNextLevel

The different query types that can be used to search for objects. See specific query definitions for more details.

query

The request to perform an action on data specified by a query.

queryRequest

This query combines two or more query objects using a Boolean AND operation thereby creating the intersection of their individual search results.

queryTypeAnd

This query allows resolved objects to be searched by their compound values (globally unique text fragments based on the values extracted from the contributing objects). Resolved objects containing one or more matching compounds are included in the search results. These values are not expected to be known by users and clients but rather they can be extracted from the results of an earlier free-text or geospatial search.

queryTypeCompound

This query allows objects to be searched by their type and identifier. Objects with matching types and identifiers are included in the search results. These values are not necessarily expected to be known by users and clients but rather they can be extracted from an earlier search result.

queryTypeObject

This query combines two or more query objects using a Boolean OR operation thereby creating the union of their individual search results.

queryTypeOr

This is the main query object and represents a free text query in a specified query language. Objects matching one or more query terms are included in the search results.

queryTypeText

The request to /relatedObjects when searching for paths between start and end objects.

relatedObjectsRequest

A collection of properties that determine the style for a relationship.

relationshipStyle

The request to /searches when performing a search including the object types to search, the query, filter, and selection criteria, as well as which visualizations to return

searchRequest

The response from /searches when performing a search including the various visualizations that can be returned.

searchResponse

The criteria by which search results are marked as selected. In order to perform certain tasks within SAS Visual Investigator, such as adding search results to a workspace or expanding nodes in a network, the search results must first be selected. Manually selecting large numbers of results can be tedious; therefore, SAND allows manual selection to be combined with query-based selection. In query-based selection, all matching objects are marked as selected. In facet-based selection, all objects matching any of the filters are marked as selected. The filter parameter represents the facet-based selection; the include parameter represents the manual and query based selections; the exclude parameter represents the manual and query based de-selections. All parameters are optional such that selections can be made by filter only, by include query only, or by object references and compound values. Objects matching either the filter or the include parameter are selected as long as they do not match the exclude parameter.

selection

The query-based selection as well as the object references and compound values representing the manually included or excluded hits.

selectionQueryAndObjectReferences

setting

settingCollection

summaryField

A synonym for synonym searching. Saved and returned in a collection via /admin/config/synonyms.

synonym

A collection of synonyms for synonym searching.

Name	Type	Required	Description
version	integer	false	The representation version (1).
types	array [string]	false	The optional list of type names for the object types to be searched. If missing, all types are searched.
query	string	false	The natural language query that Generative AI will use to determine the visualization type.

Status	Meaning	Description
200	OK	The request succeeded.		Schema
400	Bad Request	The request is malformed or contains invalid parameter values.		Schema

Determine the appropriate type of visualization for a natural language query

Request Samples

Response Samples

Request Body

Responses