Endpoint used to launch a Workflow.
POST/LaunchedWorkflows
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.
Request
Query Parameters
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.
A comma-separated list of attributes to exclude from the response. Some attributes cannot be excluded.
- application/scim+json
- */*
Body
required
Array [
]
Schemas related to Launched Workflows.
Name of the Workflow to launch.
input
undefined[]
A list of input attributes of the Launched Workflow.
The attribute key.
The attribute value.
The attribute type.
Body
required
Array [
]
Schemas related to Launched Workflows.
Name of the Workflow to launch.
input
undefined[]
A list of input attributes of the Launched Workflow.
The attribute key.
The attribute value.
The attribute type.
Responses
- 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
Array [
]
Array [
]
Array [
]
Target name of the TaskResult.
The verified date of the TaskResult.
Flag to indicate if the TaskResult is partitioned.
The completed date of the TaskResult.
Type of the TaskResult.
The launched date of the TaskResult.
Number of pending signoffs of this TaskResult.
urn:ietf:params:scim:schemas:sailpoint:1.0:LaunchedWorkflow
object
LaunchedWorkflow properties.
output
undefined[]
The output attribute type.
The output attribute value.
The output attribute key.
The number of retries performed during the execution of provisioning activities.
input
undefined[]
The input attribute key.
The input attribute value.
The input attribute type.
XML representation of the workflow summary.
Name of the workflow to launch.
Id representing the identity request.
Id representing the workflow case (a running instance of a workflow).
Target class of the Task Result.
meta
undefined[]
Metadata for the LaunchedWorkflow TaskResult.
Datetime when the TaskResult for the LaunchedWorkflow was created.
URL to the TaskResult.
Datetime of LaunchedWorkflow TaskResult last modification
Version of the LaunchedWorkflow TaskResult.
Resource type of the metadata subject
Schemas related to LaunchedWorkflow.
Name of the TaskResult for the Workflow launch.
List of messages of the TaskResult.
Attributes
object
A list of attributes of the TaskResult.
The attribute key.
The attribute value.
Id of the task result for the Workflow launch.
Possible values: [Success
, Warning
, Error
, Terminated
, TempError
]
Completion Status of the TaskResult.
Name of the TaskDefinition of the TaskResult.
Flag to indicate this TaskResult is terminated.
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"
}