Actions88
- Module Actions
- Platform Actions
- Device Actions
- Device Bay Actions
- Device Bay Template Actions
- Device Role Actions
- Device Type Actions
- Interface Actions
- Manufacturer Actions
- Module Bay Actions
- Module Bay Template Actions
- Module Type Actions
- Region Actions
- Site Actions
- Virtual Chassis Actions
- Virtual Device Context Actions
Overview
This node integrates with the NetBox API, a popular infrastructure resource modeling tool. Specifically, the "Site" resource with the "Delete" operation allows users to remove a site record from NetBox by specifying its unique identifier. This is useful in scenarios where sites are decommissioned or no longer relevant and need to be cleaned up from the inventory.
Practical examples:
- Automatically deleting a site after it has been physically closed or merged.
- Cleaning up test or temporary sites created during automation workflows.
- Integrating with other systems to synchronize site lifecycle events by removing sites from NetBox when they are deleted elsewhere.
Properties
| Name | Meaning |
|---|---|
| Domain | The domain of the NetBox API to target. Options include: DCIM, IPAM, Tenancy, Extras, Virtualization, Circuits, Core, Users, Plugins, VPN, Wireless, Status. For this operation, "DCIM" is selected. |
| Site ID | The unique identifier (ID) of the site to delete within the selected domain/resource. Required for the delete operation on the Site resource. |
Output
The node outputs JSON data representing the result of the delete operation. Typically, a successful deletion may return an empty response or confirmation status depending on the NetBox API behavior. If an error occurs, the output JSON will contain an error field with the error message.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to a NetBox instance via its REST API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- The node depends on internal helper functions to execute the HTTP request to the NetBox API.
Troubleshooting
Common issues:
- Invalid or missing Site ID: The node requires a valid site identifier; otherwise, the API will reject the request.
- Authentication errors: Ensure the API key credential is correctly set up and has permissions to delete sites.
- Network connectivity problems: The node must reach the NetBox server endpoint.
- Insufficient permissions: The API user must have rights to delete site records.
Error messages:
"error": "Not Found"— The specified Site ID does not exist."error": "Unauthorized"or"Forbidden"— Check API credentials and permissions.- Other HTTP errors returned by the NetBox API should be reviewed in the node's error output.
Resolution:
- Verify the Site ID is correct and exists in NetBox.
- Confirm API credentials and permissions.
- Check network access to the NetBox server.
- Enable "Continue on Fail" in the node settings if you want the workflow to proceed despite errors.