Get Completed Executions
This content applies solely to Appian RPA, which must be purchased separately from the Appian base platform.

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

Get Completed Executions

POST: /execution/list/completed

This method returns the list of executions completed inside the specified date range.

Request body

Parameter Example Required? Description
dateRange.start 1461457843868 Yes Date and time expressed in UNIX epoch time
Units: milliseconds
dateRange.end 1561457843866 Yes Date and time expressed in UNIX epoch time
Units: milliseconds
pageSize 50 No The number of entries to return on each page of results. Acceptable values are between 1 and 250. 250 is the default.

Example request body:

1
2
3
4
5
6
7
{
    "dateRange" : {
            "start" : 1622505600000,
            "end" : 1625097599000
    },
    "pageSize" : 2
}

Response

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

The nextPageToken property is a token used to retrieve the next page of results. To use it, append the nextPageToken key and value to your original request body. The token is valid for 10 minutes and the response keeps generating a new nextPageToken as long as there are more results to retrieve. Each subsequent request should use the nextPageToken sent back in the previous response. When nextPageToken is null in the response, the current page is the last one and there are no more entries to retrieve.

The following elements are provided in the result.executions key.

Element Example Data type Description
id 12 Integer Unique identifier of the execution
executionNumber 1 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 process custom name executed
robotId 5da9aafe4cea9d1772d9031c String Robotic process unique ID executed
nodeName "test1#1" String ID of resource where the robotic process was executed
nodeId 5da9aafe4cea9d1772d9ef72 String Unique ID of resource where the robotic process was executed
username testUsername String User who executed the robotic process
description "a test robot" String Description of the robotic process
averageTime 00h 00m 12s String Average time taken to process all work items. Computed by doing totalExecutionTime/itemsTotal
workItemAverageTime 00h 00m 13s String Average time taken to process one work item. Computed by doing totalWorkItemsTime/itemsTotal
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
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

Example response body:

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
{
    "invocationResult": "OK",
    "result": {
        "lastUpdated": 1623871619546,
        "errorMessage": null,
        "nextPageToken": null,
        "executions": [
            {
                "id": "1",
                "executionNumber": 1,
                "robotName": "5f777726b74c002dc659988e",
                "robotCustomName": "rest_test",
                "robotId": "5f777726b74c002dc659988f",
                "nodeName": "60c97b07bb4e0a77c3d38c7c#1",
                "nodeCustomName": "test-resource-927",
                "nodeId": "60c97b08bb4e0a77c3d38c7d",
                "startTimeMillis": 1623817521661,
                "endTimeMillis": 1623817527280,
                "result": "SUCCESS",
                "itemsTotal": 0,
                "itemsOk": 0,
                "itemsWarn": 0,
                "testExecution": false,
                "username": "serviceaccount",
                "description": "Execution @ test-resource (60c97b07bb4e0a77c3d38c7c#1) by serviceaccount (api)",
                "averageTime": "00h 00m 00s",
                "workItemsAverageTime": "00h 00m 00s"
            }
        ]
    },
    "exceptionThrownText": null
}

Troubleshooting

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

  • None
Open in Github Built: Wed, Aug 17, 2022 (01:05:05 PM)

On This Page

FEEDBACK