Data Hub

The Data Hub API provides access to information that is managed by SAS Visual Investigator. This API facilitates describing data that resides in either internal writable databases or external customer-controlled read-only databases. Once the data definitions are provided as entity types, the data becomes accessible within SAS Visual Investigator. This API also provides mechanisms for fetching individual entity records that were defined by the entity type definitions.

Data Stores

Contains the operations related to data store configurations.
get
Get a data store by name
Internal-Use OnlyRetrieves a data store that matches a specific name. The user name and password for the data store (required for the Create operation) are not returned in the response./admin/dataStores
post
Create a data store
Internal-Use OnlyCreates a new data store. Prior to version 10.5.1 of SAS Visual Investigator, this process could take from 30-60 seconds to complete. The "handle" property must be generated by the client. The string must be unique and contain no special characters. The "username" and "password" properties are required./admin/dataStores
put
Repair a data store
Internal-Use OnlyRepairs a data store. At times, data store information can get into a bad state. For example, during a release migration when data store metadata is being moved and a failure occurs. In these situations, use this endpoint along with the full data store content with the user name and password. Data Hub attempts to repair the state of the data store./admin/dataStores/repair/{dataStoreName}
get
Get all data stores
Internal-Use OnlyRetrieves a list of all available data stores./admin/dataStores/all
head
Get headers for user name and password for a data store
Internal-Use OnlyRetrieves headers for the data store user name and password. Other metadata about the data store is not included in the response. This endpoint requires the "svi.administration.datastore_credentials" capability. Be careful about who is given this capability. This endpoint is designed to be used by other SAS services that need the data store credentials./admin/dataStores/{dataStoreId}/credentials
get
Get user name and password for a data store
Internal-Use OnlyRetrieves the data store user name and password. Other metadata about the data store is not included in the response. This endpoint requires the "svi.administration.datastore_credentials" capability. Be careful about who is given this capability. This endpoint is designed to be used by other SAS services that need the data store credentials./admin/dataStores/{dataStoreId}/credentials
post
Test the connection to a data store
Internal-Use OnlyAttempts to connect to the data store that is specified in the request body.This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/connectionTest
get
Get the default data store
Internal-Use OnlyRetrieves the default data store. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/default
get
Get a list of supported database types
Internal-Use OnlyRetrieves a list of supported database types. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/supportedDatabaseTypes
head
Get headers for a data store by ID
Internal-Use OnlyRetrieves headers for a data store that matches the specified data store ID. The user name and password for the data store (required for the Create operation) are not returned in the response. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}
get
Get a data store by ID
Internal-Use OnlyRetrieves a data store that matches the specified data store ID. The user name and password for the data store (required for the Create operation) are not returned in the response. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}
delete
Delete a data store by ID
Internal-Use OnlyDeletes the data store that matches the specified data store ID. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}
put
Update a data store by ID
Internal-Use OnlyUpdates the data store with the specified ID to the data store definition that is contained in the request body. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}
head
Get headers for all table names from a data store
Internal-Use OnlyReturns headers for a list of all table names from the data store with the specified ID. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}/tables
get
Get all table names from a data store
Internal-Use OnlyReturns a list of all table names from the data store with the specified ID. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}/tables
head
Get headers for table metadata from a data store
Internal-Use OnlyReturns headers for table metadata from a data store for the specified data store ID and table name. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}/tables/{tableName}
get
Get table metadata from a data store
Internal-Use OnlyReturns table metadata from a data store for the specified data store ID and table name. This endpoint requires the "svi.administration.core_metadata" capability./admin/dataStores/{dataStoreId}/tables/{tableName}

Documents

Contains the operations related to documents.
post
Lock a document for editing and deletion
Internal-Use OnlyPlaces a lock on a document prior to modifying or deleting the document. If another user has a lock on the object, the request fails. Be sure to delete the lock after editing the document. A document lock times out after two hours or when the session ends; whichever occurs first./locks/documents
delete
Release a document lock
Internal-Use OnlyReleases a document lock. A document lock times out after two hours or when the session ends; whichever occurs first./locks/documents
get
Query document lock for user
Internal-Use OnlyDetermines whether the user has a lock on a document./locks/documents
post
Create a new internal document
Internal-Use OnlyCreates a new internal document. If child documents are included in the request body, new child documents are also created./documents
head
Get headers for a collection of documents by entity type
Internal-Use OnlyRetrieves headers for a collection of documents for the specified entity type. To filter the collection of documents, submit a GET via POST request./documents/{entityTypeName}
get
Get a collection of documents by entity type
Internal-Use OnlyRetrieves a collection of documents for the specified entity type. To filter the collection of documents, submit a GET via POST request. Requesting a collection of child documents is not supported./documents/{entityTypeName}
post
Filter a collection of documents
Internal-Use OnlyFilters a collection of documents by document ID or by using a custom filter. The type of filtering determines the media types to specify in the Content-Type header. This endpoint is a GET via POST. The need to use POST for this endpoint is explained for each type of request./documents/{entityTypeName}
head
Get headers for a document by ID
Internal-Use OnlyRetrieves headers for a document by ID. Both internal and external documents can be read./documents/{entityTypeName}/{documentId}
get
Get a document by ID
Internal-Use OnlyRetrieves a document by ID. You can use a parameter to specify whether child documents are returned. Both internal and external documents can be read./documents/{entityTypeName}/{documentId}
put
Update an internal document
Internal-Use OnlyUpdates an internal document. This is an appropriate way to add child documents or worksheets to the document. The content of the request is the existing document. Updating external documents is not allowed./documents/{entityTypeName}/{documentId}
patch
Patch a document
Internal-Use OnlyApplies a patch to a document. This enables a client to make changes to a document without needing to load the entire document. The request body contains a description of the changes to be made to the document, which is represented by a json-patch object. For more information about json-patch, refer to jsonpatch.com./documents/{entityTypeName}/{documentId}
delete
Delete an internal document
Internal-Use OnlyDeletes an internal document. Deleting external documents is not allowed./documents/{entityTypeName}/{documentId}
post
Bulk create and update documents
Internal-Use OnlyCreates and updates internal documents in bulk. The input is a list of document objects. Each document represents either a Create or Update operation, depending on its form. The output is a list of operation summary results./documents/bulk
head
Get headers for other documents related to an individual document
Internal-Use OnlyFor a given document and relationship type name, finds all the documents that are related to the given document according to the given relationship type./documents/{entityTypeName}/{documentId}/{relationshipTypeName}
get
Get other documents related to an individual document
Internal-Use OnlyFor a given document and relationship type name, finds all the documents that are related to the given document according to the given relationship type./documents/{entityTypeName}/{documentId}/{relationshipTypeName}
head
Get headers for field values for document
Internal-Use OnlyRetrieves headers for a representation of multiple fields values for a top-level document. Since the GET operation for this endpoint does not produce an error if the user is not authorized to reveal the value of a masked field, this HEAD operation does not either./documents/{objectTypeName}/{documentId}/fields
get
Get field values for document
Internal-Use OnlyRetrieves a representation of multiple fields values for a top-level document. If any of the fields is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If any of the fields are configured for masking and the requesting user is not authorized to reveal the value of the masked field, the value will be omitted from the response./documents/{objectTypeName}/{documentId}/fields
head
Get headers for field value for document
Internal-Use OnlyRetrieves headers for a representation of a field value for a top-level document. If the field is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the request will succeed. If the field is configured for masking and the requesting user is not authorized to reveal the value of the masked field, the request will fail./documents/{objectTypeName}/{documentId}/fields/{fieldName}
get
Get field value for document
Internal-Use OnlyRetrieves a representation of a field value for a top-level document. If the field is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If the field is configured for masking and the requesting user is not authorized to reveal the value of the masked field, the result is an error./documents/{objectTypeName}/{documentId}/fields/{fieldName}
head
Get headers for historical field value for document
Internal-Use OnlyRetrieves headers for a representation of a field value for a top-level document at a certain point in its history. If the field is currently configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the request will succeed. If the field is currently configured for masking and the requesting user is not authorized to reveal the value of the masked field, the request will fail./documents/history/{objectTypeName}/{documentId}/fields/{fieldName}
get
Get historical field value for document
Internal-Use OnlyRetrieves a representation of a field value for a top-level document at a certain point in its history. If the field is currently configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If the field is currently configured for masking and the requesting user is not authorized to reveal the value of the masked field, the result is an error./documents/history/{objectTypeName}/{documentId}/fields/{fieldName}
head
Get headers for field values for child document
Internal-Use OnlyRetrieves headers for a representation of multiple fields values for a child document. Since the GET operation for this endpoint does not produce an error if the user is not authorized to reveal the value of a masked field, this HEAD operation does not either./documents/{objectTypeName}/{documentId}/children/{childDocType}/{childDocId}/fields
get
Get field values for child document
Internal-Use OnlyRetrieves a representation of multiple fields values for a child document. If any of the fields is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If any of the fields is configured for masking and the requesting user is not authorized to reveal the value of the masked field, the value will be omitted from the response./documents/{objectTypeName}/{documentId}/children/{childDocType}/{childDocId}/fields
head
Get headers for field value for child document
Internal-Use OnlyRetrieves headers for a representation of a field value for a child document. If the field is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the request will succeed. If the field is configured for masking and the requesting user is not authorized to reveal the value of the masked field, the request will fail./documents/{objectTypeName}/{documentId}/children/{childDocType}/{childDocId}/fields/{fieldName}
get
Get field value for child document
Internal-Use OnlyRetrieves a representation of a field value for a child document. If the field is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If the field is configured for masking and the requesting user is not authorized to reveal the value of the masked field, the result is an error./documents/{objectTypeName}/{documentId}/children/{childDocType}/{childDocId}/fields/{fieldName}
head
Get headers for historical field value for child document
Internal-Use OnlyRetrieves headers for a representation of a field value for a child document at a certain point in its history. If the field is currently configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the request will succeed. If the field is currently configured for masking and the requesting user is not authorized to reveal the value of the masked field, the request will fail./documents/history/{objectTypeName}/{documentId}/children/{childDocType}/{childDocId}/fields/{fieldName}
get
Get historical field value for child document
Internal-Use OnlyRetrieves a representation of a field value for a child document at a certain point in its history. If the field is currently configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If the field is currently configured for masking and the requesting user is not authorized to reveal the value of the masked field, the result is an error./documents/history/{objectTypeName}/{documentId}/children/{childDocType}/{childDocId}/fields/{fieldName}
head
Get headers for summary of action history for a document
Internal-Use OnlyRetrieves headers for a summary of action history for a document. Action history summaries contain a link to fetch the full representation. The 'Accept-Item' request header can be used to fetch the available action types for this document. If the 'Accept-Item' header is set to "application/vnd.sas.investigate.action.type", this endpoint returns a collection of action types. This collection represents all of the action types that exist historically for the specified document, providing an exhaustive list of all possible filter options./documents/{objectTypeName}/{documentId}/actions
get
Get summary of action history for a document
Internal-Use OnlyRetrieves a summary of action history for a document. Action history summaries contain a link to fetch the full representation. The 'Accept-Item' request header can be used to fetch the available action types for this document. If the 'Accept-Item' header is set to "application/vnd.sas.investigate.action.type", this endpoint returns a collection of action types. This collection represents all of the action types that exist historically for the specified document, providing an exhaustive list of all possible filter options./documents/{objectTypeName}/{documentId}/actions
head
Get headers for an action for a document
Internal-Use OnlyRetrieves headers for the full representation of an action from a document's action history. A link to this representation is returned in the links property of an action summary./documents/{objectTypeName}/{documentId}/actions/{actionId}
get
Get an action for a document
Internal-Use OnlyRetrieves the full representation of an action from a document's action history. A link to this representation is returned in the links property of an action summary./documents/{objectTypeName}/{documentId}/actions/{actionId}
head
Get headers for summary of version history for a document
Internal-Use OnlyRetrieves headers for a summary of version history for a document. Version summaries contain a link to fetch the full version representation./documents/{objectTypeName}/{documentId}/versions
get
Get summary of version history for a document
Internal-Use OnlyRetrieves a summary of version history for a document. Version summaries contain a link to fetch the full version representation./documents/{objectTypeName}/{documentId}/versions
head
Get headers for a document version
Internal-Use OnlyRetrieves headers for the full representation of a version from a document's version history. A link to this representation is returned in the links property of a version summary./documents/{objectTypeName}/{documentId}/versions/{version}
get
Get a version for a document
Internal-Use OnlyRetrieves the full representation of a version from a document's version history. A link to this representation is returned in the links property of a version summary./documents/{objectTypeName}/{documentId}/versions/{version}
head
Get headers for a summary of version history for a child document
Internal-Use OnlyRetrieves headers for a summary of version history for a child document. Child version summaries contain a link to fetch the full child version representation./documents/{objectTypeName}/{documentId}/versions/{version}/children/{childDocType}
get
Get a summary of version history for a child document
Internal-Use OnlyRetrieves a summary of version history for a child document. Child version summaries contain a link to fetch the full child version representation./documents/{objectTypeName}/{documentId}/versions/{version}/children/{childDocType}
head
Get headers for a child document version
Internal-Use OnlyRetrieves headers for the full representation of a child version from a child document's version history. A link to this representation is returned in the "links" property of a child version summary./documents/{objectTypeName}/{documentId}/versions/{version}/children/{childDocType}/{childDocId}
get
Get a child version for a child document
Internal-Use OnlyRetrieves the full representation of a child version from a child document's version history. A link to this representation is returned in the "links" property of a child version summary./documents/{objectTypeName}/{documentId}/versions/{version}/children/{childDocType}/{childDocId}
head
Get headers for additional history information about a historical document version
Internal-Use OnlyRetrieves headers for additional history information about a historical document version. For example, this could be Create, Edit, and Delete operations on Insight objects associated with the document./documents/{objectTypeName}/{documentId}/versions/{version}/items
get
Get additional history information about a historical document version
Internal-Use OnlyRetrieves additional history information about a historical document version. For example, this could be Create, Edit, and Delete operations on Insight objects associated with the document./documents/{objectTypeName}/{documentId}/versions/{version}/items
head
Get headers for additional history information for a child document at a specific parent document version
Internal-Use OnlyRetrieves headers for additional history information for a child document at a specific parent document version./documents/{objectTypeName}/{documentId}/versions/{version}/children/{childDocType}/{childDocId}/items
get
Get additional history information for a child document at a specific parent document version
Internal-Use OnlyRetrieves additional history information for a child document at a specific parent document version./documents/{objectTypeName}/{documentId}/versions/{version}/children/{childDocType}/{childDocId}/items
Contains the operations related to relationship links.
post
Create a new relationship link between two documents
Internal-Use OnlyCreates a new relationship link between two documents. A link is an instance of a relationship type. A relationship type that describes the link must already exist. The relationship type must have an internal bridge table to create links./links
get
Get a list of links or an individual link based on specific query parameters
Internal-Use OnlyRetrieves either a list of links that are associated with a document or an individual link. The type of request is determined by the included query parameters. Do not mix the query parameters for both types of requests./links
put
Update a relationship link
Internal-Use OnlyUpdates an existing relationship link where the relationship type has an internal bridge table./links
get
Get an individual link
Internal-Use OnlyRetrieves an individual link using an ID string./links/@item
put
Update a relationship link
Internal-Use OnlyUpdates an existing relationship link where the relationship type has an internal bridge table./links/@item
patch
Patch a relationship link
Internal-Use OnlyApplies a patch to a relationship link. This enables a client to make changes to a link without needing to load the entire link. The request body contains a description of changes to be made to the link, which is represented by a json-patch object. For more information about json-patch, refer to jsonpatch.com./links/@item
delete
Delete a relationship link
Internal-Use OnlyDeletes an existing relationship link where the relationship type has an internal bridge table./links/@item
head
Get headers for field values for a relationship link
Internal-Use OnlyRetrieves headers for a representation of multiple field values for a relationship link. Since the GET operation for this endpoint does not produce an error if the user is not authorized to reveal the value of a masked field, this HEAD operation does not either./links/@item/fields
get
Get field values for a relationship link
Internal-Use OnlyRetrieves a representation of multiple field values for a relationship link. If any of the fields is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If any of the fields are configured for masking and the requesting user is not authorized to reveal the value of the masked field, the value will be omitted from the response./links/@item/fields
head
Get headers for field value for a relationship link
Internal-Use OnlyRetrieves headers for a representation of a field value for a relationship link. If the field is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the request will succeed. If the field is configured for masking and the requesting user is not authorized to reveal the value of the masked field, the request will fail./links/@item/fields/{fieldName}
get
Get field value for a relationship link
Internal-Use OnlyRetrieves a representation of a field value for a relationship link. If the field is configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If the field is configured for masking and the requesting user is not authorized to reveal the value of the masked field, the result is an error./links/@item/fields/{fieldName}
head
Get headers for historical field value for a relationship link
Internal-Use OnlyRetrieves headers for a representation of a field value for a relationship link at a certain point in its history. If the field is currently configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the request will succeed. If the field is currently configured for masking and the requesting user is not authorized to reveal the value of the masked field, the request will fail./links/history/@item/fields/{fieldName}
get
Get historical field value for a relationship link
Internal-Use OnlyRetrieves a representation of a field value for a relationship link at a certain point in its history. If the field is currently configured for masking, and if the requesting user is authorized to reveal the value of the masked field, the raw unmasked value of the field is returned. If the field is currently configured for masking and the requesting user is not authorized to reveal the value of the masked field, the result is an error./links/history/@item/fields/{fieldName}
get
Get summary of action history for a link
Internal-Use OnlyRetrieves a summary of action history for a link. Action history summaries contain a link to fetch the full representation. The 'Accept-Item' request header can be used to fetch the 'available action types' for this link. If the 'Accept-Item' header is set to "application/vnd.sas.investigate.action.type", this endpoint returns a collection of action types. This collection represents all of the action types that exist historically for the specified link, providing an exhaustive list of all possible filter options./links/@item/actions
head
Get headers for an action from the action history of a link
Internal-Use OnlyRetrieves headers for the full representation of an action from a link's action history. A link to this representation is returned in the links property of an action summary./links/@item/actions/{actionId}
get
Get an action from the action history of a link
Internal-Use OnlyRetrieves the full representation of an action from a link's action history. A link to this representation is returned in the links property of an action summary./links/@item/actions/{actionId}
get
Get summary of version history for a link
Internal-Use OnlyRetrieves a summary of version history for a link. Version summaries contain a link to fetch the full version representation./links/@item/versions
head
Get headers for a version from the version history of a link
Internal-Use OnlyRetrieves headers for the full representation of a version from a link's version history. The link to fetch the full representation is returned with version summaries./links/@item/versions/{version}
get
Get a version from the version history of a link
Internal-Use OnlyRetrieves the full representation of a version from a link's version history. The link to fetch the full representation is returned with version summaries./links/@item/versions/{version}
post
Bulk Create and Update links
Internal-Use OnlyCreates and Updates internal links in bulk. The input is a list of link objects. Each link represents either a Create or Update operation, depending on its form. The output is a list of operation summary results. The input for the request is a SAS collection, which looks like the following:/links/bulk
get
Get a count of the number of links between an entity and its related entities
Internal-Use OnlyFor a given entityTypeName and entityId, searches for all related entities and returns a summary of the total number of links found for each related entity type. This method finds all links that are related to an entity and from an entity./links/count

Entity Types

Contains the operations related to managing entity type metadata.
get
Get an entity type object by name
Internal-Use OnlyRetrieves an entity type by name. An entity type is the metadata that is associated with documents./admin/storedObjects
delete
Delete an entity type object by name
Internal-Use OnlyDeletes an entity type by name. An entity type is the metadata that is associated with documents./admin/storedObjects
head
Get headers for an entity type object by ID
Internal-Use OnlyRetrieves headers for an entity type by ID. An entity type is the metadata that is associated with documents./admin/storedObjects/{entityTypeId}
get
Get an entity type object by ID
Internal-Use OnlyRetrieves an entity type by ID. An entity type is the metadata that is associated with documents./admin/storedObjects/{entityTypeId}
delete
Delete an entity type object by ID
Internal-Use OnlyDeletes an entity type by ID. An entity type is the metadata that is associated with documents./admin/storedObjects/{entityTypeId}
get
Get all entity types
Internal-Use OnlyRetrieves all entity types in the full representation./admin/storedObjects/all
get
Get all entity types in a summary representation
Internal-Use OnlyRetrieves all entity types where each object is a summary representation of the entity type./admin/storedObjects/listAll
post
Trigger entity type metadata reconstruction
Internal-Use OnlySynchronizes an entity type's field metadata with the schema for the database table that contains the entity type's records. This can be used to repair the entity type's metadata if the table that backs the entity type changes. Care should be taken when using this operation as it does not automatically update other services in SAS Visual Investigator to reflect the metadata changes. Users who do not understand how their metadata is used in SAS Visual Investigator or are not prepared to repair inconsistencies downstream from Data Hub are not advised to use this endpoint. The request body should be empty./admin/storedObjects/{entityTypeId}/reconstruct

Relationship Types

Contains the operations related to managing relationship type metadata.
get
Get a single relationship type or an array of relationship types
Internal-Use OnlyDepending on the query parameter used, returns either a single relationship by qualified name or all relationships of a given type. Using both query parameters in a single request is not supported. Use the "qualifiedName" parameter when the looking up an individual relationship by its qualified name. The qualified name can be determined from the "qualifiedName" property in the relationship type or by constructing one. Use the "type" parameter when looking up all relationships of a given type./admin/relationships
post
Trigger relationship type metadata reconstruction
Internal-Use OnlySynchronizes the relationship type's field metadata with the schema for the database table that contains the relationship type's records. This can be used to repair the relationship type's metadata if the table that backs the relationship type changes. Care should be taken when using this operation as it does not automatically update other services in SAS Visual Investigator to reflect the metadata changes. Users who do not understand how their metadata is used in SAS Visual Investigator or are not prepared to repair inconsistencies downstream from Data Hub are not advised to use this endpoint. The request body should be empty./admin/relationships/{relationshipTypeId}/reconstruct

Transaction Types

Contains the operations related to managing transaction type metadata.
get
Get a transaction type by name
Internal-Use OnlyRetrieves a transaction type object by name. Transaction types are metadata describing transaction links./admin/transactions
head
Get headers for a transaction type object by ID
Internal-Use OnlyRetrieves headers for a transaction type object by ID. Transaction types are metadata that describe transaction links./admin/transactions/{transactionTypeId}
get
Get a transaction type object by ID
Internal-Use OnlyRetrieves a transaction type object by ID. Transaction types are metadata that describe transaction links./admin/transactions/{transactionTypeId}
get
Get all transaction types
Internal-Use OnlyRetrieves all transaction types. Transaction types are metadata that describe transaction links./admin/transactions/all
post
Trigger transaction type metadata reconstruction
Internal-Use OnlySynchronizes the transaction type's field metadata with the schema for the database table that contains the transaction type's records. This can be used to repair the transaction type's metadata if the table that backs the transaction type changes. Care should be taken when using this operation as it does not automatically update other services in SAS Visual Investigator to reflect the metadata changes. Users who do not understand how their metadata is used in SAS Visual Investigator or are not prepared to repair inconsistencies downstream from Data Hub are not advised to use this endpoint. The request body should be empty./admin/transactions/{transactionTypeId}/reconstruct

Attachments

Contains the operations related to attachments.
head
Get headers for file attachment metadata
Internal-Use OnlyRetrieves the headers for all file attachment metadata that is associated with a document. The "location" property in the response contains the relative URI path to the document. To retrieve the contents of an attachment, use that URI to download the document from the Files service: GET ${hostAndPort}${valueOfLocationProperty} ./documents/{entityTypeName}/{documentId}/attachments
get
Get file attachment metadata
Internal-Use OnlyRetrieves all file attachment metadata associated with a document. The "location" property in the response contains the relative URI path to the document. To retrieve the contents of an attachment, use that URI to download the document from the Files service: GET ${hostAndPort}${valueOfLocationProperty} ./documents/{entityTypeName}/{documentId}/attachments
post
Create file attachment metadata
Internal-Use OnlyCreates file attachment metadata on a document. To create an attachment, upload the file to the SAS Viya Files service, and then use the Files service response to construct a request to the Data Hub createDocumentAttachment endpoint./documents/{entityTypeName}/{documentId}/attachments
head
Get headers for file attachment metadata
Internal-Use OnlyRetrieves headers for the file attachment metadata that is associated with a document. The "location" property is the relative URI path to download the document from the Files service. To retrieve the contents of an attachment, use the URI that is provided in the "location" field: GET ${hostAndPort}${valueOfLocationProperty} ./documents/{entityTypeName}/{documentId}/attachments/{attachmentId}
get
Get file attachment metadata associated with a document
Internal-Use OnlyRetrieves the file attachment metadata that is associated with a document. The "location" property is the relative URI path to download the document from the Files service. To retrieve the contents of an attachment, use the URI that is provided in the "location" field: GET ${hostAndPort}${valueOfLocationProperty} ./documents/{entityTypeName}/{documentId}/attachments/{attachmentId}
delete
Delete an attachment from a document
Internal-Use OnlyDeletes an attachment that is associated with a document. The metadata and the file that are stored by the Files service are deleted./documents/{entityTypeName}/{documentId}/attachments/{attachmentId}

Comments

Contains the operations related to comments.
head
Get headers for a collection of comments
Internal-Use OnlyRetrieves headers for a collection of comments by object type and ID./documents/{objectTypeName}/{objectId}/comments
get
Get a collection of comments
Internal-Use OnlyRetrieves a collection of comments by object type and ID./documents/{objectTypeName}/{objectId}/comments
post
Create a new comment
Internal-Use OnlyCreates a new comment for the specified object type and object ID./documents/{objectTypeName}/{objectId}/comments
put
Update a comment
Internal-Use OnlyUpdates a comment on an object by specifying the object type and ID. During an Update operation, all properties of a comment are read-only except the category. This is for security and audit purposes in order to keep historical data accurate./documents/{objectTypeName}/{objectId}/comments
head
Get headers for a collection of comment category summaries
Internal-Use OnlyRetrieves headers for a collection of comment category summaries by object type and ID./documents/{objectTypeName}/{objectId}/comments/categories
get
Get a collection of comment category summaries
Internal-Use OnlyRetrieves a collection of comment category summaries by object type and ID./documents/{objectTypeName}/{objectId}/comments/categories

Files

Contains the operations related to files.
post
Create a file association object and associate it with an object
Internal-Use OnlyCreates a file association. You can create a file association by using the representation that is contained in the request body or by reusing a file that is already associated with an object. To create a file association using the representation that is contained in the request body, the file to which the file association points (via its Location property) must exist in the Files service and must not be associated with another object. To create a file association by using a file that is already associated with an object, call this endpoint without a request body and use the copyFileFrom parameter to identify the file. The Data Hub service copies the file enabling it to be associated with a different object. The object that is identified by the objectTypeName and objectId in the path is associated with the copied file./documents/{objectTypeName}/{objectId}/files
head
Get headers for the files that are associated with an object
Internal-Use OnlyRetrieves headers for the files that are associated with an object and returns them as a collection./documents/{objectTypeName}/{objectId}/files
get
Get the files that are associated with an object
Internal-Use OnlyRetrieves the files that are associated with an object and returns them as a collection./documents/{objectTypeName}/{objectId}/files
head
Get headers for file metadata
Internal-Use OnlyRetrieves headers for the file metadata for the file with the specified object type, object type ID, and file ID./documents/{objectTypeName}/{objectId}/files/{fileId}
get
Get file metadata
Internal-Use OnlyRetrieves the file metadata for the file with the specified object type, object type ID, and file ID./documents/{objectTypeName}/{objectId}/files/{fileId}
put
Update the file association object with the specified file ID
Internal-Use OnlyUpdates the file metadata for the file with the specified object type, object type ID, and file ID. You can update the following fields: name, description, displayOrder and properties. If the file association is a link to an external file, you can also update the extractedContent field. Updates to any other fields are ignored./documents/{objectTypeName}/{objectId}/files/{fileId}
delete
Delete the file with the specified file ID
Internal-Use OnlyDeletes the file with the specified ID from the object that is specified in the path./documents/{objectTypeName}/{objectId}/files/{fileId}
head
Get headers when downloading the file with the specified file ID
Internal-Use OnlyRetrieves the headers when downloading the file with the specified ID from the object that is specified in the path./documents/{objectTypeName}/{objectId}/files/{fileId}/content
get
Get the file with the specified file ID
Internal-Use OnlyDownloads the file with the specified ID from the object that is specified in the path./documents/{objectTypeName}/{objectId}/files/{fileId}/content
head
Get headers for downloading the detached file with the specified file ID
Internal-Use OnlyRetrieves the headers when downloading the file with the specified ID, for a file that is not attached to an object. Use the /documents/{objectTypeName}/{objectId}/files/{fileId}/content endpoint for a file that is attached to an object./files/{fileId}/content
get
Get the detached file with the specified file ID
Internal-Use OnlyDownloads the file with the specified ID, for a file that is not attached to an object. Use the /documents/{objectTypeName}/{objectId}/files/{fileId}/content endpoint for a file that is attached to an object./files/{fileId}/content
delete
Delete the file with the specified file ID
Internal-Use OnlyDeletes the file with the specified ID, if it is not attached to an object. Use the /documents/{objectTypeName}/{objectId}/files/{fileId} endpoint if the file is attached to an object./files/{fileId}
head
Get headers for the files that are associated with a child object
Internal-Use OnlyRetrieves headers for the files that are associated with a child object and returns them as a collection./documents/{objectTypeName}/{objectId}/children/{childDocType}/{childDocId}/files
get
Get the files that are associated with a child object
Internal-Use OnlyRetrieves the files that are associated with a child object and returns them as a collection./documents/{objectTypeName}/{objectId}/children/{childDocType}/{childDocId}/files
get
Get a file associated with a child object
Internal-Use OnlyDownloads the file with the specified ID from the child object that is specified in the path./documents/{objectTypeName}/{objectId}/children/{childDocType}/{childDocId}/files/{fileId}/content
head
Get headers when downloading a file associated with a child object
Internal-Use OnlyRetrieves the headers when downloading the file with the specified ID from the child object that is specified in the path./documents/{objectTypeName}/{objectId}/children/{childDocType}/{childDocId}/files/{fileId}/content

Sheets

Contains the operations related to sheets.
head
Get headers for a list of sheets by object type and object ID
Internal-Use OnlyRetrieves headers for a list of the sheets that are associated with the object specified in the path. To modify a sheet, update the sheets property on the object using a separate endpoint./documents/{objectTypeName}/{objectId}/sheets
get
Get a list of sheets by object type and object ID
Internal-Use OnlyRetrieves a list of the sheets that are associated with the object specified in the path. To modify a sheet, update the sheets property on the object using a separate endpoint./documents/{objectTypeName}/{objectId}/sheets
post
Copy selected sheets to the provided object
Internal-Use OnlyThe sheet copy selection included in the request body is used to copy the sheets from their location. The sheets are copied to the object specified in the path. The object to which the sheets were copied is returned as an enriched document./documents/{objectTypeName}/{objectId}/sheets
head
Get headers for a sheet
Internal-Use OnlyRetrieves headers for the sheet with the given ID from the object that is specified in the path. To modify a sheet, update the sheets property on the object using a separate endpoint./documents/{objectTypeName}/{objectId}/sheets/{sheetId}
get
Get a sheet
Internal-Use OnlyRetrieves a sheet with the given ID from the object that is specified in the path. To modify a sheet, update the sheets property on the object using a separate endpoint./documents/{objectTypeName}/{objectId}/sheets/{sheetId}

Icons

Contains the operations related to icons.
get
Get metadata for one or more icons
Internal-Use OnlyRetrieves metadata for one or more icons./icons
head
Request header for icon metadata by object type name
Internal-Use OnlyRetrieves an icon's metadata by name. Icon metadata contains information about an image./icons
get
Get icon metadata by name
Internal-Use OnlyRetrieves an icon's metadata by name. Icon metadata contains information about an image./icons/{name}
head
Get header for icon metadata by name
Internal-Use OnlyRetrieves an icon's metadata by name. Icon metadata contains information about an image./icons/{name}
get
Get an icon image by name
Internal-Use OnlyRetrieves the bytes comprising an icon image./icons/{name}/image
head
Request header for an icon image by name
Internal-Use OnlyRetrieves the bytes comprising an icon image./icons/{name}/image
get
Get an icon image by filter
Internal-Use OnlyRetrieves the bytes comprising an icon image./icons/image
head
Request header for an icon image by filter
Internal-Use OnlyRetrieves the bytes comprising an icon image./icons/image
get
Get the decoration for an icon
Internal-Use OnlyRetrieves a node decorator for an Entity or Document./icons/decoration
head
Get header for the decoration for an icon
Internal-Use OnlyRetrieves a node decorator for an Entity or Document./icons/decoration

Conditions

Contains the operations related to conditions.
post
Bulk evaluate conditions
Internal-Use OnlyEvaluates a bulk condition evaluation request. The response is a bulk condition evaluation response indicating the results of evaluating the conditions. Each individual evaluation request in the bulk request can succeed or fail independently. Each successful evaluation yields a condition evaluation response object that contains a result property. Each failed evaluation yields a condition evaluation response object that contains error details. Duplicate condition evaluation request objects in the REST request are ignored, and together result in only one condition evaluation response object in the REST response. The order of the condition evaluation response objects in the REST response is not guaranteed. In order to determine which condition evaluation response corresponds to which condition evaluation request, do not use the ordering. Instead, check the requested property of the condition evaluation response object to determine which request it corresponds to./conditionEvaluations