Sign in
Interfaces

Create a new Interface

Creates an SNMP ifTable entry for a host. These are typically created by SNMP discovery, but can also be created manually.

post/api/v1/if-entries

Request body

admin_status'Up' | 'Down' | 'Testing' required

SNMP ifAdminStatus values per IF-MIB RFC 2863

cdp_addressstring nullable

Remote management IP from CDP (cdpCacheAddress)

cdp_device_idstring nullable

Remote device ID from CDP (typically hostname, locally unique)

cdp_platformstring nullable

Remote platform from CDP (e.g., "Cisco IOS")

cdp_port_idstring nullable

Remote port ID from CDP

fdb_macsstring[] nullable

Bridge FDB: learned MAC addresses on this switch port. Single-MAC ports can be resolved to neighbor links server-side. Multi-MAC ports indicate uplinks where LLDP/CDP is the better source.

host_idstring uuid required
if_aliasstring nullable

SNMP ifAlias - user-configured description

if_descrstring required

SNMP ifDescr - interface description (e.g., GigabitEthernet0/1)

if_indexinteger required

SNMP ifIndex - stable identifier within device

if_namestring nullable

SNMP ifName - short interface name (e.g., Gi1/0/1)

if_typeinteger required

SNMP ifType - IANAifType integer (6=ethernet, 24=loopback, etc.)

ip_address_idstring uuid nullable

FK to IPAddress entity - this port's IP assignment (must be on same host). Old daemons send this as "interface_id".

lldp_mgmt_addrstring nullable

Remote management IP from LLDP neighbor (lldpRemManAddr)

lldp_port_descstring nullable

Remote port description from LLDP neighbor (lldpRemPortDesc)

lldp_sys_descstring nullable

Remote system description from LLDP neighbor (lldpRemSysDesc) - platform info

lldp_sys_namestring nullable

Remote system name from LLDP neighbor (lldpRemSysName)

mac_addressstring nullable

MAC address from SNMP ifPhysAddress - immutable once set

native_vlan_idstring uuid nullable

Native/untagged VLAN entity ID on this port (resolved from Q-BRIDGE dot1qPvid)

network_idstring uuid required
oper_status'Up' | 'Down' | 'Testing' | 'Unknown' | 'Dormant' | 'NotPresent' | 'LowerLayerDown' required

SNMP ifOperStatus values per IF-MIB RFC 2863

speed_bpsinteger nullable

Interface speed from ifSpeed/ifHighSpeed in bits per second

vlan_idsstring[] nullable

Tagged VLAN entity IDs on this port (resolved from Q-BRIDGE dot1qVlanCurrentEgressPorts)

created_atstring date-time required
first_discovery_idstring uuid nullable
idstring uuid required
last_discovery_idstring uuid nullable
last_seen_atstring date-time
lineage_idstring uuid nullable
updated_atstring date-time required
valid_fromstring date-time
valid_tostring date-time nullable

Response

If entry created successfully

errorstring nullable
successboolean required

Example response

{
  "meta": {
    "api_version": 1,
    "server_version": "0.17.7"
  }
}

Changes