Start Workflow Execution
Creates a new instance of a workflow's run, by using the passed parameters. The workflow run is an asynchronous, so the call does not return a response body.
Request
URI
POST
https://{api_host}/vco/api/workflows/{workflowId}/executions
COPY
Path Parameters
string
workflowId
Required
workflowId
Request Body
execution-context of type(s) application/json
Optional
{
"executionId": "string",
"parameter": [
{
"description": "string",
"value": {
"objectType": "string"
},
"type": "string",
"name": "string",
"scope": "string",
"updated": false,
"encrypt-value": false
}
],
"profilerOptions": {
"enabled": false,
"debuggerEnabled": false
}
}string
executionId
Optional
executionId
Responses
200
successful operation
Returns workflow-execution of type(s) application/json
{
"href": "string",
"relations": {
"total": 0,
"start": 0,
"link": [
{
"attribute": [
{
"displayValue": "string",
"value": "string",
"name": "string"
}
],
"href": "string",
"type": "string",
"rel": "string"
}
]
},
"id": "string",
"state": "string",
"inputParameters": [
{
"description": "string",
"value": {
"objectType": "string"
},
"type": "string",
"name": "string",
"scope": "string",
"updated": false,
"encrypt-value": false
}
],
"outputParameters": [
{
"description": "string",
"value": {
"objectType": "string"
},
"type": "string",
"name": "string",
"scope": "string",
"updated": false,
"encrypt-value": false
}
],
"start-date": "string",
"end-date": "string",
"business-state": "string",
"started-by": "string",
"name": "string",
"content-exception": "string",
"current-item-display-name": "string",
"workflow-item": [
{
"name": "string",
"displayName": "string",
"workflowDisplayName": "string",
"parameter": [
{
"description": "string",
"value": {
"objectType": "string"
},
"type": "string",
"name": "string",
"scope": "string",
"updated": false,
"encrypt-value": false
}
],
"href": "string",
"relations": {
"total": 0,
"start": 0,
"link": [
{
"attribute": [
{
"displayValue": "string",
"value": "string",
"name": "string"
}
],
"href": "string",
"type": "string",
"rel": "string"
}
]
}
}
],
"workflowAttributes": [
{
"description": "string",
"value": {
"objectType": "string"
},
"type": "string",
"name": "string",
"scope": "string",
"updated": false,
"encrypt-value": false
}
],
"current-item-for-display": "string",
"statistic": {
"activities": [
{
"activities": [
"activity-statistics Object"
],
"id": "string",
"total-time": 0,
"number-of-executions": 0,
"number-of-transitions": 0,
"max-time": 0
}
],
"id": "string",
"total-time": 0,
"number-of-transitions": 0,
"total-number-of-transitions": 0,
"token-size": 0,
"token-blocked": 0,
"token-system": 0,
"token-user": 0,
"token-wait": 0,
"plugins": [
{
"details": [
{
"key": "string",
"value": 0
}
],
"plugin-name": "string",
"total-time": 0,
"number-of-executions": 0
}
]
}
}string
href
Optional
href
string
id
Optional
id
string
state
Optional
state
Possible values are : CANCELED, COMPLETED, RUNNING, SUSPENDED, WAITING, STATE_WAITING_ON_SIGNAL, FAILED, INITIALIZING,
string As date-time As date-time
start-date
Optional
start-date
string As date-time As date-time
end-date
Optional
end-date
string
business-state
Optional
business-state
string
started-by
Optional
started-by
string
name
Optional
name
string
content-exception
Optional
content-exception
string
current-item-display-name
Optional
current-item-display-name
string
current-item-for-display
Optional
current-item-for-display
202
The request is successful
Operation doesn't return any data structure
400
The request is invalid(validation error)
Operation doesn't return any data structure
401
The user is not authorized
Operation doesn't return any data structure
404
Cannot find a workflow with the specified ID or the user does not have 'read' access rights for that workflow
Operation doesn't return any data structure
On This Page
Workflow Run Service Operations
POST
Answer User Interaction
DELETE
Cancel Workflow Execution
DELETE
Delete Workflow Execution
GET
Get All Executions For
GET
Get User Interaction
GET
Get Workflow Execution
GET
Get Workflow Execution Logs
GET
Get Workflow Execution State
GET
Get Workflow Execution Statistics
GET
Get Workflow Execution Syslogs
POST
Start Workflow Execution