quipteams API
POST/device-actions/external
scopedevice-actions:writereturns202rate limit30 / min

Create an external device action

Like `POST /device-actions`, but for a device that is NOT in your inventory. Requires device metadata (model or description, type or device_type, country) and always requires `current_user`. Returns 400 if the serial is actually in inventory. Responds 202 with the same detail shape.

Body

serial_numberrequired
stringSerial of a device NOT in your inventory.
action_typerequired
stringStore, Assign, Reassign, Sell, or Support.
current_userrequired
objectCurrent holder ({ name, email, ..., notification_date? }) — or { office_id } for a saved office.
new_recipient
objectRequired for Assign/Reassign. Accepts { office_id } like current_user.
model
stringDevice model. Provide model OR description.
description
stringDevice description. Provide model OR description.
type
stringDevice type. Provide type OR device_type.
device_type
stringDevice type. Provide type OR device_type.
countryrequired
stringCountry the device is in.
wipe
booleanRequest a remote wipe.
return_box
booleanInclude a return box.
notes
stringFree-text notes.
notification_emails
string[]Extra addresses to notify.

Example request

json
{
  "serial_number": "5CD1234ABC",
  "action_type": "Support",
  "device_type": "Laptop",
  "model": "Dell XPS 13",
  "country": "United Kingdom",
  "current_user": {
    "name": "Jordan Price",
    "email": "jordan@acme.com",
    "country": "United Kingdom",
    "address": "10 King St, London EC2V 8EA"
  },
  "notes": "Keyboard replacement"
}