Free cookie consent management tool by TermsFeed

Get Robotic Task List

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.

Get robotic task list

POST: /robot/list

This method returns the list of all robotic tasks that the user is allowed to view.

Request body

This endpoint accepts no request parameters. You may have to add an empty JSON ({}) to the raw request to receive a response.

Response

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

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

Element Example Data type Description
id "5da9aafe4cea9d1772d9031c" String Robotic task ID
name "5da9aafe4cea9d1772d9031b" String Robotic task name, immutable since creation
customName "Example task" String Robotic task human-readable name
spokenName "Example task" String Robotic task spoken name
expressions "delta": ["four"] Map Map of expressions
environment "a": "alfa", "b": "beta", "z": "3" Array List of environmental values
itemsName "bits" String Items friendly name
description - String Robotic task description
involvedSystems - - -
inputExpected - - Input expected by the robotic task
outputExpected - - Output expected from the robotic task
disabled false Boolean Indicates if executions are disabled
testing false Boolean Indicates if testing mode is active
minimumLogLevel "TRACE" String Default log level, possible values are: TRACE, DEBUG, INFO, WARN, ERROR, FATAL
priority "HIGH" String The execution's priority level, relative to other executions
simultaneousRunning 3 Integer Maximum simultaneous executions for the robotic task (0 means no limit)
restrictHours false Boolean Indicates if executions are restricted to specified hours
restrictHoursSchedule - Array Array of schedule data if previous field is set to true
restrictHoursSchedule.id 5da9aafe4cea9d1772d9031c String Robotic task ID
restrictHoursSchedule.robotName null String -
restrictHoursSchedule.description - String Robotic task description
restrictHoursSchedule.active false Boolean -
restrictHoursSchedule.color "#000000" String Hexidecimal code for the color this robotic task uses in graphics
restrictHoursSchedule.minutes "type": "WHEN", "every": 0, "when": [] Array -
restrictHoursSchedule.hours "type": "WHEN", "every": 0, "when": [11, 12, 17, 18] Array -
restrictHoursSchedule.days "type": "WHEN", "every": 0, "when": [] Array -
restrictHoursSchedule.daysOfWeek "type": "WHEN", "every": 0, "when": [6, 0] Array Days of the week in Java calendar format
restrictHoursSchedule.instructions - - Not used
restrictHoursSchedule.executionsToLaunch - - Not used
removeOldArtifacts 0 Integer Days to removed artifacts (0 means never)
subResultTexts "RED": "red", "CORAL": "australia", "LIGHT_GRAY": "discrete", "LIME": "fresh", "CHOCOLATE": "sweet", "OLIVE": "", "MAGENTA": "highlight", "CYAN": "sky", "DARK_GRAY": "shadow", "INDIGO": "deep" Array Descriptions of colors to categorize items results in the robotic task
lastExecution 1569245555136 String Date and time of the robotic task's last execution, expressed in UNIX epoch time
Units: milliseconds
color "#9fe1e7" String Hexidecimal code for the color this robotic task uses in graphics
labels "dev", "developer", "internet-explorer", "remote", "windows!", "chrome-75" Array Array to data regarding robotic task permissions
instructions "name": "fail", "description": "fail", "type": "BOOLEAN", "defaultValue": "false", "required": false Array Array of data regarding robotic task parameters
rolemaps [{"role":"ADMINISTRATOR","users":["userName"],"groups":[]},{"role":"VIEWER","users":[],"groups":["RPA Operations Managers"]}] Array Indicates the security role maps assigned to the robotic tasks and robots; multiple role maps can be included.

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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
{
    "invocationResult": "OK",
    "result": {
        "lastUpdated": 1627659438694,
        "errorMessage": null,
        "robots": [
            {
                "name": "60b7dd32e4b0ca0d6e6341a8",
                "id": "5efb185af9e21a2764d22393",
                "customName": "Documentation",
                "spokenName": null,
                "expressions": {},
                "environment": {},
                "itemsName": "items",
                "description": null,
                "involvedSystems": null,
                "inputExpected": null,
                "outputExpected": null,
                "disabled": false,
                "testing": false,
                "minimumLogLevel": "TRACE",
                "priority": "NORMAL",
                "simultaneousRunning": 0,
                "restrictHours": false,
                "restrictHoursSchedule": null,
                "removeOldArtifacts": 0,
                "subResultTexts": {},
                "lastExecution": 0,
                "color": "#000000",
                "labels": [
                    "roleoperation"
                ],
                "instructions": [],
                "technology": "JAVA",
                "rolemaps": [
                    {
                        "role": "ADMINISTRATOR",
                        "users": ["userName"],
                        "groups": []
                    },
                    {
                        "role": "VIEWER",
                        "users": [],
                        "groups": ["RPA Operations Managers"]
                    }
                ]
            },
            {
                "name": "60ccc933e4b0ca0d6e6341ae",
                "id": "5efb1872f9e21a2764d22396",
                "customName": "Browser",
                "spokenName": null,
                "expressions": {},
                "environment": {},
                "itemsName": "items",
                "description": null,
                "involvedSystems": null,
                "inputExpected": null,
                "outputExpected": null,
                "disabled": false,
                "testing": false,
                "minimumLogLevel": "TRACE",
                "priority": "NORMAL",
                "simultaneousRunning": 0,
                "restrictHours": false,
                "restrictHoursSchedule": null,
                "removeOldArtifacts": 0,
                "subResultTexts": {},
                "lastExecution": 0,
                "color": "#000000",
                "labels": [
                    "roleoperation"
                ],
                "instructions": [],
                "technology": "JAVA",
                "rolemaps": [
                    {
                        "role": "ADMINISTRATOR",
                        "users": ["userName"],
                        "groups": []
                    },
                    {
                        "role": "VIEWER",
                        "users": [],
                        "groups": ["RPA Operations Managers"]
                    }
                ]
            },
            {
                "name": "61040365e4b0c8349a1c3366",
                "id": "5efb1872f9e21a2764d22396",
                "customName": "APPN-Stock-Price",
                "spokenName": "",
                "expressions": {},
                "environment": {},
                "itemsName": "items",
                "description": "",
                "involvedSystems": "",
                "inputExpected": "",
                "outputExpected": "",
                "disabled": false,
                "testing": false,
                "minimumLogLevel": "TRACE",
                "priority": "NORMAL",
                "simultaneousRunning": 0,
                "restrictHours": false,
                "restrictHoursSchedule": null,
                "removeOldArtifacts": 0,
                "subResultTexts": {
                    "RED": "",
                    "CORAL": "",
                    "LIGHT_GRAY": "",
                    "LIME": "",
                    "CHOCOLATE": "",
                    "OLIVE": "",
                    "MAGENTA": "",
                    "CYAN": "",
                    "DARK_GRAY": "",
                    "INDIGO": ""
                },
                "lastExecution": 1627654956579,
                "color": "#000000",
                "labels": [
                    "roleoperation"
                ],
                "instructions": [],
                "technology": "JAVA",
                "rolemaps": [
                    {
                        "role": "ADMINISTRATOR",
                        "users": ["userName"],
                        "groups": []
                    },
                    {
                        "role": "VIEWER",
                        "users": [],
                        "groups": ["RPA Operations Managers"]
                    }
                ]
            }
        ]
    },
    "exceptionThrownText": null
}
Copy

Troubleshooting

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

  • None

Feedback