Start Presentation

Start Presentation

Creates a new instance of the presentation of a workflow, by using the passed parameters. To create a new instance of a workflow presentation, make an HTTP GET request at the URL that contains the instances of the workflow presentation. Presentation's fields are populated with input parameter values and are validated. If there are any validation errors, they are collected and attached to each field. The presentation is marked as invalid. In order the returned workflow presentation to be localized, add Accept-Language header, with the appropriate locale. In advance, localization resource should be present for the workflow, otherwise it defaults to the standard workflow presentation.

Request
URI
POST
https://{api_host}/vco/api/workflows/{workflowId}/presentation/instances
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

array of parameter
parameter
Optional

parameter

profilerOptions
Optional

profilerOptions

Responses
200

The request is successful

Returns execution of type(s) application/json
{
    "steps": [
        {
            "readOnly": false,
            "elements": [
                {
                    "id": "string",
                    "hidden": false,
                    "display-name": "string",
                    "description": "string",
                    "messages": [
                        {
                            "Summary": "string",
                            "Details": "string",
                            "severity": "string",
                            "code": "string"
                        }
                    ]
                }
            ],
            "id": "string",
            "description": "string",
            "display-name": "string",
            "hidden": false,
            "messages": [
                {
                    "Summary": "string",
                    "Details": "string",
                    "severity": "string",
                    "code": "string"
                }
            ]
        }
    ],
    "parameters": [
        {
            "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"
            }
        ]
    },
    "id": "string",
    "name": "string",
    "description": "string",
    "object-id": "string",
    "valid": false,
    "start-date": "string",
    "started-by": "string"
}
array of StepInfo
steps
Optional

steps

array of parameter
parameters
Optional

parameters

string
href
Optional

href

relations
Optional

relations

string
id
Optional

id

string
name
Optional

name

string
description
Optional

description

string
object-id
Optional

object-id

boolean
valid
Optional

valid

string As date-time As date-time
start-date
Optional

start-date

string
started-by
Optional

started-by


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