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.
POST: /robot/runWithParams
This method launches a robotic task with or without parameters.
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}"
}
]
}
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
}
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"):
Execute Robotic Task with Parameters