Registration

POST /registration/register

Register device from Redfish/BMC data

Register a physical server into NetBox using Redfish system information

Request JSON Object:

• device_info (any) – Required: Redfish device info

• device_name (string) – Optional: Override device name

• role_name (string) – Optional: Device role (default: “Server”)

• site_id (integer) – Required: NetBox site ID

Status Codes:

• 201 Created – Device registered successfully

• 400 Bad Request – Invalid request payload

• 500 Internal Server Error – Internal server error

• 503 Service Unavailable – NetBox not configured

Response JSON Object:

• asset_tag (string)

• created (boolean) – true if newly created, false if updated

• device_id (integer)

• device_name (string)

• device_role (string)

• device_type (string)

• device_url (string)

• manufacturer (string)

• serial (string)

POST /registration/unregister-device

Unregister device from NetBox

Deletes a device and all associated IP addresses, MAC addresses, interfaces, and inventory items

Query Parameters:

• device_id (integer) – NetBox device ID to unregister

Status Codes:

• 200 OK – Device unregistered successfully

• 400 Bad Request – Invalid request payload

• 500 Internal Server Error – Internal server error

• 503 Service Unavailable – NetBox not configured

Response JSON Object:

• device_id (integer)

• interfaces_deleted (integer)

• inventory_items_deleted (integer)

• ips_deleted (integer)

• macs_deleted (integer)

• message (string)