Free cookie consent management tool by TermsFeed

Execute Robotic Task with Parameters

The capabilities described on this page are included in Appian's standard capability tier. Usage limits may apply.

Tip:  Remember to include the appropriate authentication headers in your HTTP request message when using this method.

Execute robotic task with parameters

POST: /robot/runWithParams

This method launches a robotic task with or without parameters.

Request body

Parameter Example Required? Description
robotName "5e7dd431e4b08f477f06ba65" Yes Name of the robotic task to launch. This is not the id (in mongo format) nor the custom name. You can get the name of the robotic task using the method /rest/oo/robot/list in the output field id and use it here.
nodeName "5e865b4c4412e6bf6ccf7637#1" No Name of the robot on which the execution must be run. This is not the id (in mongo format) nor the custom name. You can get the name of the robot using the method /rest/oo/node/list in the output field name and use it here.
description "Example description" No Description for the execution.
stepMode false No Indicates whether the step-by-step mode applies or not.
instructions - No Array of data; each of the parameters the robotic task needs to be executed.
instructions.name "batch" No The name of the parameter in the robotic task's configuration.
instructions.fileNameValue "my-file.txt" No It must be set only if the parameter is a file type. In this case, value must contain the content of the file in BASE64 format.
instructions.value 20 No The value for the parameter for the execution.

Example request body:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
    "robotName": "5f84ca6d94cc0d5799b50bc9",
    "nodeName": "5e865b4c4412e6bf6ccf7637#1",
    "description": "Example description",
    "stepMode": false,
    "instructions": [
        {
            "name": "textList",
            "value": "{\"#t\": \"string?list\", \"#v\":[\"test1\",\"test2\"]}"
        },
        {
            "name": "singleDecimal",
            "value": "{\"#t\": \"decimal\", \"#v\":1.2}"
        }
    ]
}

Response

The call is successful if "invocationResult" = "OK".

Element Example Data type Description
id "5" Integer Execution identifier
robotExecutionId "61040365e4b0c8349a1c3366#5" String A combination of the robotic task identifier and the execution number displayed in the Operations Console. The value before # symbol is the identifier of the robotic task, and the value after the # symbol is the execution number.

Example response body:

1
2
3
4
5
6
7
8
9
10
{
    "invocationResult": "OK",
    "result": {
        "lastUpdated": 1627660857846,
        "errorMessage": null,
        "id": "5",
        "robotExecutionId": "61040365e4b0c8349a1c3366#5"
    },
    "exceptionThrownText": null
}

Troubleshooting

If the robotic task uses a variable of type Array or CDT, then this method will fail.

Possible reasons calls may be unsuccessful ("invocationResult" = "KO"):

  • None

Feedback