Get Hierarchy

Description

'Get Hierarchy' returns a hierarchical list of the Asset Menu (folders, flows, data etc.). The returned hierarchy contains detailed information about the following types of items: 'Folder', 'Flow', 'DataFile', 'SubFlow', 'InteractiveImage', 'DesktopElement', 'WebElement', 'InteractiveImageCollection'.

The ItemIDs in the hierarchy can be used to import the Import/Export endpoints. Individual itemIds can also be used as 'targetItemId' in Import/Export endpoints.

Request URL

http://{controllerMachine}:{controllerPort}/api/v4/hierarchy/{itemId}

Input parameters

Field Type Description Comments
itemId string Optional: Unique identifier for Items in the Asset hierarchy, if not provided then it returns all existing hierarchy items The itemId can be from the following types of items:
- 'Folder'
- 'Flow'
- 'DataFile'
- 'SubFlow'
- 'InteractiveImage'
- 'DesktopElement'
- 'WebElement'

- 'InteractiveImageCollection'

Examples

Curl


curl -X GET --header 'Accept: application/json' --header 'AccessKey: Mo87Nc4qDAtzJNDb' 'http://{controllerMachine}:{controllerPort}/api/v4/hierarchy/{itemId}'

PowerShell 

$headers = @{}
$headers.Add("AccessKey","Mo87Nc4qDAtzJNDb")
Invoke-WebRequest -Uri "http://{controllerMachine}:{controllerPort}/api/v4/hierarchy/{itemId}" -ContentType "application/json" -Headers $headers -Method GET

Response Body

List of Variables

[
    {
    "$id": "1",
    "Id": "a3caa583-6243-4cf0-a411-2d4fdabc0e53",
    "Title": "Projects",
    "Type": "Folder",
    "DateCreation": "12/19/2018 12:38:02 PM +00:00",
    "DateModify": "12/19/2018 12:38:02 PM +00:00",
    "Children": [
            {
                "$id": "2",
                "Id": "87705158-39ba-4148-8cdb-8e8227e69df7",
                "Title": "Automation case 1",
                "Type": "Flow",
                "ParentId": "a3caa583-6243-4cf0-a411-2d4fdabc0e53",
                "DateCreation": "10/3/2018 1:46:29 PM +00:00",
                "DateModify": "12/19/2018 1:36:30 PM +00:00",
                "Children": []
            }
        ]
    },
    {
    "$id": "3",
    "Id": "74821680-c687-4b4c-8872-59ab47e1af8c",
    "Title": "RPA Flow",
    "Type": "Flow",
    "PreviousSiblingId": "a3caa583-6243-4cf0-a411-2d4fdabc0e53",
    "DateCreation": "10/3/2018 1:46:39 PM +00:00",
    "DateModify": "12/19/2018 12:39:26 PM +00:00",
    "Children": []
     },
    {
    "$id": "4",
    "Id": "e2b5912c-254b-406a-bf4f-5771fa8b7e30",
    "Title": "Citrix Test",
    "Type": "Flow",
    "PreviousSiblingId": "74821680-c687-4b4c-8872-59ab47e1af8c",
    "DateCreation": "10/3/2018 1:46:50 PM +00:00",
    "DateModify": "12/19/2018 12:39:39 PM +00:00",
    "Children": []
    }
]

 

Response Object

Field Type Description Values
$id string ID of internal item (Folder/ Flow/Element etc.)  
Title string Title of item  
Type string Type of item 'Folder','Flow','SubFlow','InteractiveImage',
'DesktopElement','WebElement','DataFile'
'InteractiveImageCollection'
PreviousSiblingId string Previous item Id  
DateCreation string Item Creation date  
DateModify string Item Modification date  
Children List<AssetHierarchyApiInfo> List of all children  
AssetHierarchyApiInfo List of objects    
$id string ID of internal item (Folder/ Flow/Element etc.)  
Title string Title of item  
Type string Type of item 'Folder','Flow','SubFlow','InteractiveImage',
'DesktopElement','WebElement','DataFile'
'InteractiveImageCollection'
ParentId string Parent item Id  
DateCreation string Item Creation date  
DateModify string Item Modification date  
Children List<AssetHierarchyApiInfo> List of all children  


Response Code

200 (OK)

404 (Not Found)

401 (Unauthorized, Incorrect access Keys)

400 (Bad Request)

404 (Asset Not Found)

500 (Internal Server Error)