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 of type(s) application/json
Optional
{
    "parameters": [
        {
            "description": "string",
            "encryptValue": false,
            "name": "string",
            "scope": "string",
            "type": "string",
            "updated": false,
            "value": {
                "inputType": "string"
            }
        }
    ]
}
parameters
Optional

parameters

Authentication
This operation uses the following authentication methods.
Responses
201

Workflow execution instance has been created

Returns WsWorkflowExecution of type(s) application/json;version=38.0
{
    "businessState": "string",
    "contentException": "string",
    "currentItemDisplayName": "string",
    "endDate": "string",
    "id": "string",
    "inputParameters": [
        {
            "description": "string",
            "encryptValue": false,
            "name": "string",
            "scope": "string",
            "type": "string",
            "updated": false,
            "value": {
                "inputType": "string"
            }
        }
    ],
    "name": "string",
    "outputParameters": [
        {
            "description": "string",
            "encryptValue": false,
            "name": "string",
            "scope": "string",
            "type": "string",
            "updated": false,
            "value": {
                "inputType": "string"
            }
        }
    ],
    "relations": {
        "total": 0,
        "link": [
            {
                "attributes": [
                    {
                        "displayValue": "string",
                        "name": "string",
                        "value": "string"
                    }
                ],
                "href": "string",
                "rel": "string",
                "type": "string",
                "name": "string"
            }
        ],
        "start": 0
    },
    "startDate": "string",
    "startedBy": "string",
    "state": "string"
}
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

inputParameters
Optional

inputParameters

string
name
Optional

name

outputParameters
Optional

outputParameters

relations
Optional

relations

string As date-time As date-time
startDate
Optional

startDate

string
startedBy
Optional

startedBy

state
Optional

state


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