Start Workflow Execution

Start Workflow Execution

Instantiates a workflow run, by using the passed parameters. The workflow run is asynchronous, so the call returns a pointer to a task that can be used to track the workflow run.

Request
URI
POST
https://{api_host}/cloudapi/workflows/{workflowId}/executions
COPY
Path Parameters
string
workflowId
Required

workflowId

Request Body

executionContext

ExecutionContext of type(s) application/json
Optional 
{
    "parameters": [
        {
            "description": "string",
            "encryptValue": false,
            "name": "string",
            "scope": "string",
            "type": "string",
            "updated": false,
            "value": {
                "inputType": "string"
            }
        }
    ]
}
Authentication
This operation uses the following authentication methods.
Responses
201

Workflow execution instance has been created

Returns WsWorkflowExecution of type(s) application/json;version=39.1 
"WsWorkflowExecution Object"
string
businessState
Optional

businessState

string
contentException
Optional

contentException

string
currentItemDisplayName
Optional

currentItemDisplayName

string As date-time As date-time
endDate
Optional

endDate

string
id
Optional

id

array of object
inputParameters
Optional

Definition of WsParameter.

string
name
Optional

name

array of object
outputParameters
Optional

Definition of WsParameter.

object
relations
Optional

Definition of Relations.

string As date-time As date-time
startDate
Optional

startDate

string
startedBy
Optional

startedBy

string
state
Optional

state

Possible values are : canceled, completed, running, suspended, waiting, waiting-signal, failed, initializing,

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

403

Forbidden

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

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/cloudapi/workflows/{workflowId}/executions
Deprecated
Availability
Added in 30.0
Deprecated in 36.0
With alternative: see
vRO Forms Overlay API Marked As Internal
Removed in 39.0
On This Page
Vro Workflow Execution Operations
GET
Get Parameter Types
Deprecated
GET
Get Supported Presentation Elements
Deprecated
GET
Get Supported Decorators
Deprecated
GET
Get Supportedconstraints
Deprecated
GET
Get All Workflow Executions
POST
Start Workflow Execution
Deprecated
GET
Get Workflow Execution
Deprecated
DELETE
Delete Workflow Execution
GET
Get Workflow Execution State
DELETE
Cancel Workflow Execution