Manage inventories

This topic explains how to maintain inventories after initial creation, including clearing and removing inventories.

Inventory Manager consumes data from your inventory systems — it is not the authoritative source for device data.

To avoid data drift, repopulate inventories from your source system.

Clear an inventory

Remove all nodes from an inventory without deleting the inventory itself.

This is useful when:

  • Decommissioning devices and need to empty an inventory temporarily
  • Testing inventory population workflows
  • Preparing to repopulate from a different inventory system

Using workflows

Use the clearInventory task in Studio.

Using API

1DELETE /inventory_manager/v1/nodes/clear/:identifier

Example request:

1DELETE /inventory_manager/v1/nodes/clear/prod-routers

Example response:

1{
2 "status": "Success",
3 "result": {
4 "nodesDeleted": 150
5 }
6}

Delete an inventory

Delete an inventory after removing all its nodes:

1

Clear the inventory

Remove all nodes from the inventory.

2

Delete the inventory

Delete the inventory once it is empty.

Using workflows

Use the deleteInventory task in Studio.

Using API

1DELETE /inventory_manager/v1/inventories/:identifier

Example request:

1DELETE /inventory_manager/v1/inventories/prod-routers

Example response:

1{
2 "status": "Success",
3 "result": {
4 "deletedCount": 1
5 }
6}