Create Folder Hierarchy 

Description

'Create Folder Hierarchy' endpoint is used to create folder(s) with specific hierarchical structure in Leapwork. To create folder hierarchy enter folder titles one after another separated by '/' symbol. After successful creation of folder endpoint returns HierarchyItemId which is the hierarchy item id in which the folder hierarchy is going to be created. 

The ItemId parameter is the item id of pre-existing Flow or Folder under which new Item need to be added. If itemId is null or empty, folder hierarchy will be created in the root folder.

Please note that hierarchy like “..folder1/folder2/” and “..folder1//folder2“ are not allowed.

Request URL

http://{controllerMachine}:{controllerPort}//api/v3/hierarchy/create/folder/{itemId}

Input parameters

Examples

Curl

curl -X PUT --header 'Accept: application/json' --header 'AccessKey: Mo87Nc4qDAtzJNDb' 'http://{controllerMachine}:{controllerPort}/api/v3/hierarchy/create/folder/{itemId}'

PowerShell 

$headers = @{}
$headers.Add("AccessKey","123qwe")
Invoke-WebRequest -Uri "http://autobotvm001:9001/api/v3/hierarchy/create/folder?folder=Project1/Feature1" -ContentType "application/json" -Headers $headers -Method PUT 

Response Body

List of Variables

Response Object

Response Code

200 (OK)

401 (Unauthorized, incorrect access key)

400 (Incorrect parameter 'folder' key or its value)

409 (API Returns 409 error, If ItemId cannot create folder or ItemId already contains folder item with the same title or ItemId already contains same hierarchy)

500 (Internal Server Error)