name: netbox-mac-endpoint-gotcha
description: "MAC-Adressen in NetBox 4.x nur per dcim/mac-addresses-API, netbox.netbox 3.23 schreibt sie nicht"
metadata:
node_type: memory
type: project
originSessionId: 5d862faf-b55b-4b39-89c4-ae01dda6c5a1
modified: 2026-07-24T17:16:33.118Z


In NetBox 4.x sind MAC-Adressen eigene Objekte (dcim/mac-addresses/), nicht mehr
ein Feld am Interface. Die netbox.netbox 3.23 Collection kann diesen Endpoint
nicht bedienen — netbox_device_interface mit mac_address läuft ohne Fehler
durch, aber die MAC landet als None.

Why: Bei blackbox (enp4s0, 192.168.1.168) ergänzt in [[crumbforest-node-aliases]]:
Interface + IP kamen sauber Ăźbers Playbook [netbox-crew.yml], die MAC blieb leer.

How to apply: MAC einmalig per API pflegen — POST an dcim/mac-addresses/ mit
assigned_object_type: dcim.interface + assigned_object_id: <iface-id>, dann PATCH
das Interface mit primary_mac_address: <mac-id>. Danach spiegelt NetBox sie ins
mac_address-Feld zurück. Bewusster Drift zum Repo — in netbox-crew.yml als Kommentar
an der lan_mac-Zeile dokumentiert. Token-Falle siehe [[netbox-token-und-rename]].