Start Workflow Execution

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:///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": "boolean",
            "encrypt-value": "boolean"
        }
    ],
    "profilerOptions": {
        "enabled": "boolean",
        "debuggerEnabled": "boolean"
    }
}
string
executionId
Optional

executionId

array of parameter
parameter
Optional

parameter

profilerOptions
Optional

profilerOptions

Responses
200

successful operation

Returns workflow-execution of type(s) application/json
{
    "href": "string",
    "relations": {
        "total": "integer",
        "start": "integer",
        "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": "boolean",
            "encrypt-value": "boolean"
        }
    ],
    "outputParameters": [
        {
            "description": "string",
            "value": {
                "objectType": "string"
            },
            "type": "string",
            "name": "string",
            "scope": "string",
            "updated": "boolean",
            "encrypt-value": "boolean"
        }
    ],
    "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": "boolean",
                    "encrypt-value": "boolean"
                }
            ],
            "href": "string",
            "relations": {
                "total": "integer",
                "start": "integer",
                "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": "boolean",
            "encrypt-value": "boolean"
        }
    ],
    "current-item-for-display": "string",
    "statistic": {
        "activities": [
            {
                "activities": [
                    "activity-statistics Object"
                ],
                "id": "string",
                "total-time": "integer",
                "number-of-executions": "integer",
                "number-of-transitions": "integer",
                "max-time": "integer"
            }
        ],
        "id": "string",
        "total-time": "integer",
        "number-of-transitions": "integer",
        "total-number-of-transitions": "integer",
        "token-size": "integer",
        "token-blocked": "integer",
        "token-system": "integer",
        "token-user": "integer",
        "token-wait": "integer",
        "plugins": [
            {
                "details": [
                    {
                        "key": "string",
                        "value": "integer"
                    }
                ],
                "plugin-name": "string",
                "total-time": "integer",
                "number-of-executions": "integer"
            }
        ]
    }
}
string
href
Optional

href

relations
Optional

relations

string
id
Optional

id

string
state
Optional

state

array of parameter
inputParameters
Optional

inputParameters

array of parameter
outputParameters
Optional

outputParameters

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

workflow-item
Optional

workflow-item

array of parameter
workflowAttributes
Optional

workflowAttributes

string
current-item-for-display
Optional

current-item-for-display

statistic
Optional

statistic


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