RestApiCategories.visualInvestigator.desc

visual_investigator

2024.09

2024.03

Viya_35

2025.09

2025.03

2025.12

2026.01

2026.02

2026.03

The SAS Visual Investigator Workflow API enable users to execute and manage workflows created within SAS Visual Investigator. The SAS Visual Investigator workflows are based on an open-source engine that complies with the Business Process Model and Notation (BPMN) 2.0 standard. It supports industry standards for visual representation and behavior, and it provides support for established workflow patterns. SAS Visual Investigator workflows are efficient and scalable, and integrate with other standard business process implementations.

Visual Investigator Workflow

Claims a selection of workflow tasks. This request allows for 100 selections.

Performs a bulk claim for the selected tasks.

A representation of the selected element.

selectionRep

This indicates which client is issuing the request.  Accepted values include desktop and mobile.

VI-Client-Application

The name of the user to whom this task is assigned.

assignee

This is an example of an error returned for bad requests.

Error

application/vnd.sas.error

An example URL including the base path for this service that is based off svi-datahub.

Claim a selection of workflow tasks

actionRep

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)

Base Collection

columnPreferenceRep

A collection of settings for displaying grid columns.

columnSettingRep

A simple representation with name and ID.

genericReferenceRep

A simple representation with an ID and version.

genericVersionReferenceRep

A collection of work metrics details per workflow, user, or group.

historicalMetricsSummaryRep

A collection of information  about the process metric summary.

historicalMetricsSummaryRepResourceCollection

A collection of information about a workflow task's history.

historicalWorkflowTaskRep

A collection of workflow process history.

historicalWorkflowTaskRepResourceCollection

A link to a related operation or resource.

Link

The page template details that are used when completing workflow tasks.

pageDetailsRep

The page template used when completing workflow tasks.

pagePromptRep

A participant assigned to a workflow task

participantRep

sortPreferenceRep

variableRep

A representation of a workflow instance's context.

workflowInstanceContextRep

workflowProcessRep

workflowProcessRepResourceCollection

A representation of a workflow definition view.

workflowRep

workflowRepResourceCollection

A representation of workflow settings applied per user.

Name	Type	Required	Description
resources	array [string]	false	A list of resource keys.
version	integer<int32>	false	This media type's schema version number. This representation is version 1.

Status	Meaning	Description
204	No Content	The operation was successful.
400	Bad Request	The request was invalid.		Schema

Claim a selection of workflow tasks

Request Samples

Response Samples

Query Parameters

Header Parameters

Request Body

Responses