Import CSV endpoint

/api/open/nodes/import allows you to enrich the information associated to nodes by uploading a comma-separated value (CSV) file. Each row affects the nodes matching the specified ip field value. When there are no matches, new nodes are created.

Requirements and Restrictions

  1. The authenticated user must be in a group with admin role
  2. Only CSV files with a header are accepted
  3. There must be an ip column
  4. In addition to ip, only the fields listed below and custom fields are considered. Every other provided field will be ignored. If you need to provide values for custom fields, please make sure that the names of these custom fields have been already created.
    label
    firmware_version
    vendor
    product_name
    serial_number
    os
    mac_address
    type

Example of CSV file

ip,label,firmware_version,vendor,product_name,serial_number,os,mac_address,type
192.168.1.57,node 57,1.2.2,ACME,ACME Product 0,abcdefg,Windows XP SP3,00:00:00:11:11:11,computer
    
Figure 1. Example of the request

Example of the request