quipteams API
POST/devices
scopeassets:writereturns201

Add devices

Accepts a single device object, a bare array, or `{ "devices": [...] }` (max 100). A single-object body returns a single asset; a bulk body returns an array. A serial already registered to your company returns 409 CONFLICT.

Body

serial_numberrequired
stringDevice serial number.
device_typerequired
stringe.g. Laptop, Monitor, Keyboard.
countryrequired
stringCountry the device is held in.
descriptionrequired
stringHuman-readable description, e.g. "MacBook Pro 14 M3".
employee
stringAssigned employee name.
condition
stringe.g. New, Good, Fair.
cost
numberUnit cost. Non-numeric values are rejected. Never echoed back.

Example request

json
{
  "devices": [
    {
      "serial_number": "C02X5K3JMD6T",
      "device_type": "Laptop",
      "country": "United States",
      "description": "MacBook Pro 14 M5 Pro",
      "condition": "Good",
      "cost": 2199
    }
  ]
}

Example response

json
{
  "data": [
    {
      "id": "c3d4e5f6-0718-4293-a4b5-c6d7e8f90a1b",
      "serial_number": "C02X5K3JMD6T",
      "company": "Acme",
      "country": "United States",
      "device_type": "Laptop",
      "description": "MacBook Pro 14 M5 Pro",
      "employee": null,
      "condition": "Good",
      "status": "in_use",
      "quantity": 1,
      "completion_date": null,
      "created_at": "2026-02-20T08:00:00.000Z",
      "updated_at": "2026-02-20T08:00:00.000Z",
      "purchase_order": null,
      "assigned_date": "2026-02-20"
    }
  ]
}