Manage data and workflows and search and discovery

visual_investigator

2024.09

2024.10

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

2024.07

2024.08

2024.03

2023.03

2023.10

Viya_35

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

Deletes all of the indexed objects and relationships matching the given query. If no request body is provided, then all of the indexed objects and relationships will be deleted. This operation cannot be undone without first making a backup of the indexed data directly from the underlying search engine.

An example of a request to /admin/data that deletes all objects containing "john" in the forename field and "smith" in the surname field.

An example of an and query that finds objects matching both text queries.

An example of a compound query that finds resolved entity objects with the given compound values.

An example of an object query that finds a person object and an address object by their identifiers.

An example of an or query that finds objects matching either the text query or the and query.

An example of a free text query that finds objects containing "john" in the forename field and "smith" in the surname field.

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

Whether to preserve and reuse the name of the newest index for each type when creating the next searchable index. Creating new unsearchable indexes, or deleting indexes without this option, will cause the new indexes to have new unique names. Preserving the newest index name is useful when maintaining a read-only standby deployment for Disaster Avoidance as it allows the data to be re-indexed without changing the index name. For example, when applying a breaking configuration change from the active deployment.

preserveNewestIndexName

Whether type category aliases should be excluded from the search. In particular, this should be set to true when the intention is to delete system relationships without deleting custom relationships as they both share the same type category alias.

excludeCategoryAliases

Whether to wait for any index-related operations to be applied prior to the response being returned.

waitForRefresh

The request is malformed or contains invalid parameter values.

An example URL including the base path for this API.

Delete by 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 will be 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

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

analyticsResults

analyticsResult

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.

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 groups highlighting snippets by child entity.

childEntityHighlighting

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

childEntityHighlightingParameters

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

childObjectHighlighting

The request and response for /admin/config when importing and exporting a configuration between systems.

configuration

An edge within the context of the Network visualization. An edge represents a relationship between two entity objects or between a resolved entity 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

Describes the fields to retrieve for a given entity.

entityFields

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

entityStyle

error2

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 will be 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 will be 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 will be included in the search results.

filterTypePolygon

Filters objects based on the given query. Objects matching the query will be 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 will be 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 will be 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 will be 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 will be included in the search results.

filterTypeTerms

Filters objects by their type. Objects of the named types will be 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 entity

index

indexCollection

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

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

operationRequest

The parameters for the refresh configuration operation

operationRequestParametersForRefreshConfiguration

The parameters for the make index searchable operation.

operationRequestParametersForMakeIndexSearchable

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

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 entity objects to be searched by their compound values (globally unique text fragments based on the values extracted from the resolved entity's contributing objects). Resolved entity objects containing one or more matching compounds will be included in the search results. These values are not expected to be known by users/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 will be included in the search results. These values are not necessarily expected to be known by users/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 will be 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 and therefore SAND allows manual selection to be combined with query-based selection (all matching objects are marked as selected) and facet-based selection (all objects matching any of the filters will be 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 will be 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.

synonymCollection

The request to /traversals for performing a breadth first graph search in the Network visualization

Name	Type	Required	Description
excludeCategoryAliases	boolean	false	Whether type category aliases should be excluded from the search. In particular, this should be set to true when the intention is to delete system relationships without deleting custom relationships as they both share the same type category alias. Default: false
preserveNewestIndexName	boolean	false	Whether to preserve and reuse the name of the newest index for each type when creating the next searchable index. Creating new unsearchable indexes, or deleting indexes without this option, will cause the new indexes to have new unique names. Preserving the newest index name is useful when maintaining a read-only standby deployment for Disaster Avoidance as it allows the data to be re-indexed without changing the index name. For example, when applying a breaking configuration change from the active deployment. Default: false
waitForRefresh	boolean	false	Whether to wait for any index-related operations to be applied prior to the response being returned. Default: false

Name	Type	Required	Description
version	integer	false	The representation version (2).
types	array [string]	false	The optional list of type names for the object and relationship types to be searched. If missing, all types will be searched.
query	Query or anyOf QueryTypeAndQueryTypeCompoundQueryTypeObjectQueryTypeOrQueryTypeText	false	The different query types that can be used to search for objects. See specific query definitions for more details.

Status	Meaning	Description
204	No Content	The request succeeded.
400	Bad Request	The request is malformed or contains invalid parameter values.		Schema

Delete by query

Request Samples

Response Samples

Query Parameters

Request Body

Responses