netbox-diode
Installation
SKILL.md
NetBox Diode SDK
Diode is a gRPC-based data ingestion service for NetBox. Instead of managing dependency order and object IDs via the REST API, you describe objects by name and the Diode reconciler resolves dependencies, creates missing objects, and performs upserts automatically.
This skill covers the open-source Python and Go SDKs (diode-sdk-python v1.12.0 / diode-sdk-go v1.9.0), targeting NetBox 4.5.x–4.6.x. The Diode server and reconciler are proprietary — this skill describes their observable behavior, not internals.
Your knowledge of Diode SDK may be outdated. Entity types, SDK methods, and reconciler behavior evolve between releases. Prefer retrieval over pre-trained knowledge.
Retrieval Sources
| Source | URL / Method | Use for |
|---|---|---|
| Diode docs | https://netboxlabs.com/docs/diode/ |
Architecture, getting started |
| Diode Python SDK | https://netboxlabs.com/docs/diode/sdk/python/ |
Python SDK reference |
| Python SDK repo | https://github.com/netboxlabs/diode-sdk-python |
Source, entity types, changelog |
| Go SDK repo | https://github.com/netboxlabs/diode-sdk-go |
Source, entity types, changelog |
| Protobuf reference | https://netboxlabs.com/docs/diode/diode-proto/ |
Entity schema definitions |
| NetBox MCP server | If configured — verify objects created by Diode landed correctly | Post-ingestion validation |