Import business devices from CSV

Creates or updates business devices from a CSV file, matched by serial number. Headers are case-insensitive and can be in Spanish or English.

Required columns: Tipo/Type, Ubicacion/Location, Fase/Phase, Marca/Brand, Modelo/Model, Serie/Series.

The type must be an existing device type, and the location and phase must exist in the Datacenter, Atom/Edge or DR Work Places event types.

Optional columns: Propietario/Owner, and technical details (Pod Ur/Rack Unit, Rack Gabinete/Rack Cabinet, Num Fuentes/Power Supply, Amperes/Amps, Voltaje/Voltage, Conector Nemas/Nema Plug, Cant Rack/Slots, Cant Consumo/Power Consumption (kW), Componentes, Camaras, any other column) stored in details.

One business (businessid is an ID): a serial number that belongs to another business is rejected.

All businesses (businessid is the literal undefined): each row needs id_salesforce, and only devices that already belong to that business are updated.

No permission is checked: any signed-in user can call it.

Requires a valid session token. No permission is required.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Import result

application/json

Import result.

Bodyapplication/json

Example

{
    "devices": {
        "insertedCount": 0,
        "matchedCount": 12,
        "modifiedCount": 10,
        "deletedCount": 0,
        "upsertedCount": 3,
        "upsertedIds": {
            "12": "65f1c2a9e4b0a1b2c3d4e5a1"
        },
        "insertedIds": {}
    },
    "errors": [
        {
            "type": "Invalid",
            "property": "Ubicacion/Fase",
            "row": 4
        }
    ]
}

🟠400The `csv` file is missing

🟠401The session token expired

🟠403The `Authorization` header is missing, the token is invalid,

🟠404No datacenter locations or device types are configured

🔴500Unexpected error