Endpoint used to launch a Workflow.​
Endpoint to launch or execute a Workflow. A payload for the request is required and this can include inputs specific to the Workflow being launched.
Query Parameters
- attributes string
A comma-separated list of attributes to return in the response. This query parameter supersedes excludedAttributes, so providing the same attribute(s) to both will result in the attribute(s) being returned.
- excludedAttributes string
A comma-separated list of attributes to exclude from the response. Some attributes cannot be excluded.
- application/scim+json
- */*
Request Body required
- schemas undefined[]
Schemas related to Launched Workflows.
- workflowName string
Name of the Workflow to launch.
input undefined[]
A list of input attributes of the Launched Workflow.
key stringThe attribute key.
value stringThe attribute value.
type stringThe attribute type.
Request Body required
- schemas undefined[]
Schemas related to Launched Workflows.
- workflowName string
Name of the Workflow to launch.
input undefined[]
A list of input attributes of the Launched Workflow.
key stringThe attribute key.
value stringThe attribute value.
type stringThe attribute type.
- 201
Executes a workflow and returns the resulting LaunchedWorkflow. LaunchedWorkflow responses include attributes from the TaskResult related to the Workflow execution.
- application/json
- Schema
- Example (from schema)
Schema
- targetName string
Target name of the TaskResult.
- verified date-time
The verified date of the TaskResult.
- partitioned boolean
Flag to indicate if the TaskResult is partitioned.
- completed date-time
The completed date of the TaskResult.
- type string
Type of the TaskResult.
- launched string
The launched date of the TaskResult.
- pendingSignOffs integer
Number of pending signoffs of this TaskResult.
urn:ietf:params:scim:schemas:sailpoint:1.0:LaunchedWorkflow object
LaunchedWorkflow properties.
output undefined[]
type stringThe output attribute type.
value stringThe output attribute value.
key stringThe output attribute key.
retries integerThe number of retries performed during the execution of provisioning activities.
input undefined[]
key stringThe input attribute key.
value stringThe input attribute value.
type stringThe input attribute type.
workflowSummary stringXML representation of the workflow summary.
workflowName stringName of the workflow to launch.
identityRequestId stringId representing the identity request.
workflowCaseId stringId representing the workflow case (a running instance of a workflow).
- targetClass string
Target class of the Task Result.
meta undefined[]
Metadata for the LaunchedWorkflow TaskResult.
created date-timeDatetime when the TaskResult for the LaunchedWorkflow was created.
location stringURL to the TaskResult.
lastModified date-timeDatetime of LaunchedWorkflow TaskResult last modification
version stringVersion of the LaunchedWorkflow TaskResult.
resourceType stringResource type of the metadata subject
- schemas undefined[]
Schemas related to LaunchedWorkflow.
- name string
Name of the TaskResult for the Workflow launch.
- messages undefined[]
List of messages of the TaskResult.
Attributes object
A list of attributes of the TaskResult.
key stringThe attribute key.
value stringThe attribute value.
- id string
Id of the task result for the Workflow launch.
- completionStatus string
Possible values: [
Success
,Warning
,Error
,Terminated
,TempError
]Completion Status of the TaskResult.
- taskDefinition string
Name of the TaskDefinition of the TaskResult.
- terminated boolean
Flag to indicate this TaskResult is terminated.
- launcher string
Launcher of the TaskResult.
{
"targetName": "Ernest.Wagner",
"verified": "2022-05-26T11:17:13.481-05:00",
"partitioned": false,
"completed": "2022-05-26T11:17:13.678-05:00",
"type": "LCM",
"launched": "string",
"pendingSignOffs": 0,
"urn:ietf:params:scim:schemas:sailpoint:1.0:LaunchedWorkflow": {
"output": [
{
"type": "application/int",
"value": "0",
"key": "workflowSummary"
}
],
"retries": 0,
"input": [
{
"key": "optimisticProvisioning",
"value": "true",
"type": "boolean"
}
],
"workflowSummary": "<WorkflowSummary step=\"end\"/>\n",
"workflowName": "LCM Manage Passwords.",
"identityRequestId": "0000000004",
"workflowCaseId": "c0a8019c810011478181012862b81568"
},
"targetClass": "Identity",
"meta": [
{
"created": "2022-03-31T14:52:40.245-05:00",
"location": "http://localhost:8080/identityiq/scim/v2/TaskResults/c0a8019c810011478181012862b51567",
"lastModified": "2022-03-31T14:52:40.265-05:00",
"version": "\"W\"1649951092552\"",
"resourceType": "LaunchedWorkflow"
}
],
"schemas": [
[
"urn:ietf:params:scim:schemas:sailpoint:1.0:LaunchedWorkflow",
"urn:ietf:params:scim:schemas:sailpoint:1.0:TaskResult"
]
],
"name": "LCM Manage Passwords - 2",
"messages": [
[
"Connection error"
]
],
"Attributes": {
"key": "retries",
"value": "0"
},
"id": "c0a8019c810011478181012862b51567",
"completionStatus": "Success",
"taskDefinition": "Workflow Launcher",
"terminated": false,
"launcher": "spadmin"
}