---
parent: /workflows/agents.md
back_out_url: /workflows/agents.md
---

# Workflow 7: DeviceHub Browse (Bulk Tag Discovery)

> You are at https://api.litmus.io/workflows/browse-bulk-tags.md
> Parent: https://api.litmus.io/workflows/agents.md
> If this is the wrong workflow, back out to the index above.

## 7. DeviceHub Browse (Bulk Tag Discovery)

**UI trigger**: DeviceHub -> Browse -> Select tags -> Create All

The Browse workflow auto-discovers a device's full address space (e.g. all OPC UA nodes or Modbus registers) and lets users select which ones to import as tags - without manually entering each one.

### Step table

| Step | API Name | Method | Endpoint / GraphQL Operation | Input | Output / What to capture |
|------|----------|--------|------------------------------|-------|--------------------------|
| 1 | Create Browse Task | `POST` | `{{edgeUrl}}/devicehub/v2` -> `CreateBrowseTask` | Device ID + browse params | Browse Task `ID` |
| 2 | Start Browse Task | `POST` | `{{edgeUrl}}/devicehub/v2` -> `StartBrowseTasks` | Browse Task `ID` from step 1 | Task starts crawling |
| 3 | List Browse Tasks *(poll)* | `POST` | `{{edgeUrl}}/devicehub/v2` -> `ListBrowseTasks` | - | Poll until `Status = Completed` |
| 4 | Get Browse Task Folders | `POST` | `{{edgeUrl}}/devicehub/v2` -> `BrowseTask_GetFoldersForTreeView` | Browse Task `ID` | Folder tree of discovered address space |
| 5 | Get Browse Folder Items | `POST` | `{{edgeUrl}}/devicehub/v2` -> `BrowseTask_GetFolderItems` | Folder path within the browse task | Items (tags/nodes) in that folder |
| 6 | Cart Add Items | `POST` | `{{edgeUrl}}/devicehub/v2` -> `Cart_AddItems` | Selected item IDs from step 5 | Items added to cart (`Added`, `Skipped`, `Updated` counts) |
| 6b | Cart Update Properties *(optional)* | `POST` | `{{edgeUrl}}/devicehub/v2` -> `Cart_UpdateProperties` | Cart item IDs + property overrides | Updated counts |
| 7 | Cart Create All Registers | `POST` | `{{edgeUrl}}/devicehub/v2` -> `Cart_CreateAllRegisters` | No input - processes entire cart | `Created`, `Skipped`, `Updated` counts - tags now exist |

> **Also useful**: `Download Browse Tags` (`GET /devicehub/browsing/download_csv/task/{task_id}`) - exports discovered tags to CSV before committing. Lets users review in Excel before creating.


---