List the NetBox object types these tools accept, with their API endpoints.

Types are named 'app.model' (e.g. 'dcim.device'). Plugin types appear when the server runs with plugin discovery enabled.

List NetBox objects of one type, with filtering and pagination.

Returns 'results' plus 'total' (all matches) and 'has_more'/'next_offset'. Results are paginated - check 'has_more' before concluding. To count objects cheaply use fields=['id'] and limit=1 and read 'total'.

Examples: netbox_get_objects('dcim.device', {'site_id': 3, 'status': 'active'}, fields=['id', 'name', 'primary_ip4']) netbox_get_objects('ipam.ipaddress', {'parent': '10.0.0.0/24'}, fields=['address', 'dns_name'])

Get one NetBox object by type and ID.

Search several NetBox object types at once with NetBox's 'q' filter.

Returns results keyed by object type. A '_meta' key appears when some types failed ('errors' - treat as unknown, NOT as "no match") or had more matches than 'limit' ('truncated' - the full count per type).

Describe the writable fields of an object type: type, required, choices.

Call this before creating or updating an object to build a valid payload. Foreign keys take the related object's numeric ID.

List change log entries (who changed what and when), newest first.

Each entry has action (create/update/delete), user_name, time, changed_object_type/id and object_repr. Entries of one request share a request_id. Set include_data to see what exactly changed.

Get NetBox version, installed plugins and apps, worker status and the authenticated user. Also reports this server's read-only/dry-run modes.

Run a read-only GraphQL query against NetBox's /graphql/ endpoint.

Use it to fetch nested data that would otherwise need many REST calls. Mutations and subscriptions are rejected. Always paginate large lists, e.g. device_list(pagination: {limit: 50}).

List free IPs, child prefixes, VLAN IDs or ASNs in a pool.

Examples: free IPs in prefix 12 -> ('ipam.prefix', 12, 'ips'); free /24s in a prefix -> ('ipam.prefix', 12, 'prefixes'); free VLAN IDs in group 3 -> ('ipam.vlangroup', 3, 'vlans').

Trace cable paths from a port through patch panels and circuits.

For an interface, console, power port/outlet or power feed: the path from it to the far end, one hop (near end, cable, far end) per segment. For a pass-through port (front/rear port, circuit termination): every cable path running through it, each as its list of nodes.

Render the configuration of a device or VM from its assigned config template (NetBox config templates + config context). Changes nothing, but NetBox only allows it for API tokens with write enabled.

Create one NetBox object. Returns the created object.

Look up related objects first (netbox_get_objects) and pass their IDs.

Update fields of one NetBox object (partial update). Returns the updated object.

Create many objects of one type in a single transaction (all or nothing). Returns the IDs of the created objects.

Update many objects of one type in a single transaction (all or nothing).

Allocate the next free IP, prefix, VLAN or ASN from a pool and create it. NetBox picks the value atomically, so concurrent callers never get the same one.

Permanently delete one NetBox object. Dependent objects may be deleted with it (e.g. a device's interfaces). Confirm with the user first.

Permanently delete many objects of one type in a single transaction. Confirm with the user first.