Devices API (Manifest)

Manage OT/ICS device inventory.

List Devices

GET /api/v1/devices

Query Parameters:

Parameter	Type	Description
siteId	UUID	Filter by site
vendor	string	Filter by vendor name
deviceType	string	Filter by type (plc, hmi, switch, etc.)
status	string	Filter by status (up, down, warning)
page	number	Page number (default: 1)
limit	number	Results per page (default: 50)

Get Device

GET /api/v1/devices/:id

Returns full device details including metrics, CVE matches, and configuration history.

Create Device

POST /api/v1/devices

{
  "siteId": "uuid",
  "hostname": "PLC-Line4-Main",
  "ipAddress": "192.168.10.50",
  "vendor": "Rockwell",
  "model": "ControlLogix 5580",
  "deviceType": "plc",
  "firmwareVersion": "33.011",
  "purdueLevel": 1
}

Update Device

PUT /api/v1/devices/:id

Delete Device

DELETE /api/v1/devices/:id