Free cookie consent management tool by TermsFeed

Cancel Executions

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.

Cancel executions

POST: /execution/cancel

This method aborts all robotic tasks with IDs that match the given list of robotic task IDs and statuses.

Request body

Parameter Type Example Required? Description
robotIds List of String ["60cb47c3546ede51ffe04dbb",
"5dcd86ed17d0b602a53ce2d1"]
Yes List of unique robotic task identifiers and the execution number displayed in Appian. The value before # symbol is the identifier of the robotic task, and the value after the # symbol is the execution number seen in Appian.
status String "ENQUEUED" Yes A robotic task can have the status "ENQUEUED", "RUNNING", or "SCHEDULED".

Example request body:

1
2
3
4
{
    "robotIds" : ["60cb47c3546ede51ffe04dbb#13","5dcd86ed17d0b602a53ce2d1#41"],
    "status" : "ENQUEUED"
}
Copy

Response

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

Element Example Data type Description
executions See below List of Execution The list of execution objects that correspond with canceled executions.
id 13 Integer Unique identifier of the execution
executionNumber 13 Integer The number of the execution displayed in the RPA console. This value is not necessarily unique and can be re-used in the user interface as old executions are deleted and new executions run.
robotName "robot-tutorial-QuickStart" String Robotic task custom name executed.
robotCustomName "testRobot" String Human-readable name given to the robotic task.
robotId "5da9aafe4cea9d1772d9031c" String Robotic task unique ID executed.
nodeName "test1#1" String ID of the robot that executed the robotic task.
nodeId "5da9aafe4cea9d1772d9ef72" String Unique ID of the robot that executed the robotic task.
starttimeMillis 1542281894653 Integer Date and time when execution started, expressed in UNIX epoch time.
Units: milliseconds.
endTimeMillis 1542281901183 Integer Date and time when execution ended, expressed in UNIX epoch time.
Units: milliseconds.
duration 3334 String The length of time it took to execute the task.
Units: milliseconds
result "SUCCESS" String Result of execution.
itemsTotal 1 Integer Total items processed.
itemsOk 1 Integer Total items processed with SUCCESS result.
itemsWarn 0 Integer Total items processed with WARN result.
testExecution "false" String Boolean indicating whether this execution was a test.
username "testUsername" String User who executed the robotic task.
description "a test robot" String Description of the robotic task.
averageTime "00h 00m 12s" String Average time taken to process all work items. Calculated as totalExecutionTime/itemsTotal
workItemAverageTime "00h 00m 13s" String Average time taken to process one work item. Calculated as totalWorkItemsTime/itemsTotal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
    "invocationResult": "OK",
    "result": {
        "lastUpdated": 1671033366520,
        "errorMessage": null,
        "nextPageToken": null
        "executions": [
            {
                "id": "13",
                "executionNumber": 13,
                "robotName": "63974fdc497630026cf29757",
                "robotCustomName": "RobotName",
                "robotId": "60cb47c3546ede51ffe04dbb",
                "nodeName": null,
                "nodeCustomName": null,
                "nodeId": null,
                "startTimeMillis": 0,
                "endTimeMillis": 0,
                "duration": 0,
                "result": "ENQUEUED",
                "itemsTotal": 0,
                "itemsOk": 0,
                "itemsWarn": 0,
                "testExecution": false,
                "username": "administrator",
                "description": "",
                "averageTime": "00h 00m 00s",
                "workItemsAverageTime": "00h 00m 00s",
                "failedSectionName": null
            }
        ]
    },
    "exceptionThrownText": null
}
Copy

Troubleshooting

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

  • The robotic task ID is null or invalid.
  • The requester doesn't have permissions to at least one requested robotic task.

Feedback