Knowledge base
Tips and tricks Best practice guides, FAQ & more
Find tutorials, guides and use case examples in the
Learning centerGet All Agents
Get All Agents returns a list of all Agents currently configured on the Controller. The returned list of Agents will give access to the Name, IDs, UsedBySchedules etc. of the Agent that are needed to call other endpoints in the API.
http://{controllerMachine}:{controllerPort}/api/v4/agents
http://{controllerMachine}:{controllerPort}/api/v4/agents?temporary=true
if the “temporary=true” parameter is set then Agents will get the temporary schedules.
curl -X GET --header 'Accept: application/json' --header 'AccessKey: Mo87Nc4qDAtzJNDb' 'http://{controllerMachine}:{controllerPort}/api/v4/agents'
$headers = @{}
$headers.Add("AccessKey","Mo87Nc4qDAtzJNDb")
Invoke-WebRequest -Uri "http://{controllerMachine}:{controllerPort}/api/v4/agents" -ContentType "application/json" -Headers $headers -Method GET
List of variables:
[{ "$id": "1", "UsedBySchedules": [ { "$id": "2", "ScheduleId": "5fe6164e-017b-45c8-adc5-8d7e7b560bd4", "ScheduleTitle": "Test" } ], "HostName": "ec2-18-194-110-160.eu-central-1.compute.amazonaws.com", "Port": 6777, "DisplayWidth": 1280, "DisplayHeight": 1024, "ConnectionTimeout": 10000, "ConnectionType": "RemoteAgent", "DateCreation": { "$id": "3", "Value": "2018-12-04T07:51:03.4600097+00:00", "LocalDateTime": "2018-12-04T13:21:03.4600097", "UtcDateTime": "2018-12-04T07:51:03.4600097", "Ticks": 636795066634600100 }, "DateModify": { "$id": "4", "Value": "2018-12-04T07:51:03.4600097+00:00", "LocalDateTime": "2018-12-04T13:21:03.4600097", "UtcDateTime": "2018-12-04T07:51:03.4600097", "Ticks": 636795066634600100 }, "Title": "Amazon WS2016", "Type": "Environment", "Id": "527653f0-f239-4173-9d5d-07a2184eb646" } ] |
Field | Type | Description | Values |
---|---|---|---|
$id | String | ID of the internal item (Folder/ Flow/Element etc.) | |
Title | String | Title of item | |
Type | String | Type of item | 'Folder','Flow','SubFlow','InteractiveImage', 'DesktopElement','WebElement','DataFile' 'InteractiveImageCollection' |
IsDeleted | Bool | true/false | |
DateCreation | DapperDateTimeOffset | Item Creation date | |
DateModify | DapperDateTimeOffset | Item Modification date | |
DapperDateTimeOffset | Object | Object holds values for DateCreation and DateModify | "$id","Value","LocalDateTime", "UtcDateTime","Ticks" |
Description | String | ||
ConnectionType | String | Type of Agent example remoteAgent | |
ConnectionTimeout | Int | ||
IsDisabled | bool | ||
LocalIdentifier | string | ||
IsWebLocal | Bool | ||
PixelRatio | Int | ||
MobileDeviceOrientation | String | portrait/landacape | |
MobileDevice | String | ||
OSVersion | String | ||
OS | String | ||
OSType | String | ||
UserName | String | ||
UserProfile | String | ||
UserAgent | String | ||
BrowserVersion | String | ||
BrowserHeight | Int | ||
BrowserWidth | Int | ||
Browser | String | ||
Display | Int | ||
DisplayHeight | Int | ||
DisplayWidth | Int | ||
Port | Int | ||
HostName | String | ||
UsedBySchedules | Object | List of schedules using the environment | List of {ScheduleId and ScheduleTitle} |
Response Code
200 (OK)
404 (Not Found)
401 (Unauthorized)
400 (Bad Request)
500 (Internal Server Error)
©2024, Leapwork. All rights reserved.