Create gridlastic


The endpoint 'Create gridlastic' is used to create an environment of Gridlastic type in Leapwork. After successful creation of Gridlastic environment, the Id of the environment is returned in response.

The details of the created environment can be validated with the help of  Get environment by id endpoint.

Request URL


Input parameters

Property Type Description Comments
requestBody application/json

Unique identifiers for the Gridlastic environment comprising following parameters:

  • Port
  • Title
  • Description
  • HubUserName
  • SubDomain
  • HubPassword
  • OSType
  • OSVersion
  • Browser
  • BrowserVersion

Kindly refer the documentation for Environments for more details on the usage.




curl -X PUT --header 'Accept: application/json' --header 'AccessKey: Mo87Nc4qDAtzJNDb' -d '{ \
"Port": "80", \
"Title": "My Gridlastic Agent", \
"Description": "Gridlastic  Agent", \
"HubUserName": "LeapworkUser", \
"SubDomain": "domainName", \
"HubPassword": "Password", \
"OSType": "Windows", \
"OSVersion": "10", \
"Browser": "Chrome", \
"BrowserVersion": "latest"

}' 'http://{controllerMachine}:{controllerPort}/api/v3/enviroments/create/gridlastic'


$headers = @{}

$requestBody = @'
    "Port": "80",
    "Title": "My Gridlastic Agent",
    "Description": "Gridlastic Agent",
    "HubUserName": "LeapworkUser",
    "SubDomain": "domainName",
    "HubPassword": "Password",
"OSType": "Windows",
    "OSVersion": "10",
    "Browser": "Chrome",
    "BrowserVersion": "latest"


Invoke-WebRequest -Uri "http://{controllerMachine}:{controllerPort}/api/v3/environments/create/gridlastic" -ContentType "application/json" -Headers $headers -Method PUT  -Body $requestBody

Response Body

CreateEnvironmentResponse object:


  "$id": "1",

  "EnvironmentId": "4d9c09fe-7ced-4494-8841-378491ebc899"



Response Object

Field Type Description Values
$id String ID of internal item(Folder/ Flow/Element etc.)  
EnvironmentId String ID of the environment created  

Response Code

200 (OK)

404 (Not Found)

401 (Incorrect Access Key)

400 (Bad Request, asset not found)

500 (Internal Server Error)