Manage inventories

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

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

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

Example request:

1
DELETE /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:

Using workflows

Use the deleteInventory task in Studio.

Using API

1
DELETE /inventory_manager/v1/inventories/:identifier

Example request:

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

Example response:

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