Update Sauce Labs
Description
The endpoint Update Sauce Labs is used to update an Agent of the Sauce Labs type in Leapwork. After the successful update of your Sauce Labs Agent, the Id of the agent is returned in the response.
The details of the updated agent can be validated with the help of the Get Agent by Id endpoint.
Please note this endpoint will work with the Leapwork Platform Edition only.
Request URL
(PUT) http://{controllerMachine}:{controllerPort}/api/v4/agents/update/saucelabs/{agentId}
Input parameters
|
Field
|
Type
|
Description
|
Comment
|
|
accessKey
|
string
|
An access key is required to restrict unauthorized access to the API.
|
Access Key should include an agent scope to access the API.
|
|
agentId
|
string
|
Unique id of agent
|
|
|
requestBody
|
application/json
|
Unique identifiers for the Sauce Labs Agent comprising the following parameters:
· Title
· Description
· UserName
· AccessKey
· OSType
· OSVersion
· Browser
· BrowserVersion
· MobileDevice
· Screen Resolution
|
Kindly refer to the documentation for Agents for more details on the usage.
|
Examples
Curl
curl -X PUT --header 'Accept: application/json' --header 'AccessKey: Mo87Nc4qDAtzJNDb' -d '{ \
"Title": "My Sauce Labs Agent Environment", \
"Description": "Sauce Labs Agent", \
"HostName": "192.168.1.100", \
"AccessKey": "Password", \
"OSType": "Windows", \
"OSVersion": "10", \
"Browser": "Chrome", \
"BrowserVersion": "latest", \
"MobileDevice": "Android GoogleAPI Emulator",\
"ScreenResolution": { \
"Width": 0, \
"Height": 0 \
}, \
}' 'http://localhost:9001/api/v4/agents/update/saucelabs/1a8d0f39-ce50-4a35-bed1-770b4de3f957'
PowerShell
$headers = @{}
$headers.Add("accessKey","Mo87Nc4qDAtzJNDb")
$requestBody = @'
{
"Title": "My Sauce Labs Agent Environment",
"Description": "Sauce Labs Agent",
"HostName": "192.168.1.100",
"AccessKey": "Password",
"OSType": "Windows",
"OSVersion": "10",
"Browser": "Chrome",
"BrowserVersion": "latest",
"MobileDevice": "Android GoogleAPI Emulator",
"ScreenResolution": {
"Width": 0,
"Height": 0
},
}
'@
Invoke-WebRequest -Uri "http://localhost:9001/api/v4/agents/update/saucelabs/1a8d0f39-ce50-4a35-bed1-770b4de3f957" -ContentType "application/json" -Headers $headers -Method PUT -Body $requestBody
Response
Update agent and returns true for successful operation completion in the response.
{
"$id": "1",
"AgentId": "1a8d0f39-ce50-4a35-bed1-770b4de3f957",
"IsSuccessful": true
}
Response object
|
Field
|
Type
|
Description
|
Values
|
|
$id
|
string
|
ID of internal object
|
|
|
AgentId
|
string
|
ID of the Agent updated
|
|
|
IsSuccessful
|
bool
|
Returns ‘true’ for successful operation
|
true| false
|
Response Code
200 (OK)
400 (Bad Request – eg: “Invalid endpoint for Enterprise version")
401 (Unauthorized - eg: “Incorrect Accesskey”)
403 (Forbidden – eg: “AccessKey does not have the relevant scope permission”)
500 (Internal Server Error)
.svg "Leapwork")
