quipteams

POST/device-actions

scopedevice-actions:writereturns202rate limit30 / min

Create a device action

Creates an action for a device already in your inventory (looked up by serial). `Assign`/`Reassign` require `new_recipient`. Returns 409 if an action is already open on the device (or a wipe is pending, for any action except Sell). Starts fulfillment asynchronously (202) and returns the detail shape with `comments: []`.

Body

serial_numberrequired

stringSerial of a device in your inventory.

action_typerequired

stringStore, Assign, Reassign, Sell, or Support.

current_user

objectCurrent holder ({ name, email, country?, address?, phone?, notification_date? }). Required unless the device is in storage. Or pass { office_id } to name a saved office (GET /api/v1/offices) — the office supplies country + address (rejected alongside it), must sit in the device's country, and needs a contact email on file or an email in this object.

new_recipient

objectNew holder ({ name, email, ..., notification_date? }) — or { office_id } for a saved office, same rules as current_user. Required for Assign/Reassign. When every side is an office, the action lands coordinated with no scheduling form (the address is on file).

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": "C02X5K3JMD6T",
  "action_type": "Reassign",
  "current_user": {
    "name": "Alex Doe",
    "email": "alex@acme.com",
    "country": "United States",
    "address": "123 Market St, San Francisco, CA 94103"
  },
  "new_recipient": {
    "name": "Sam Lee",
    "email": "sam@acme.com",
    "country": "United States",
    "address": "500 Congress Ave, Austin, TX 78701"
  },
  "wipe": true,
  "notes": "Employee change - wipe before reassigning"
}

Example response

json

{
  "data": {
    "id": "e5f60718-2934-4b5c-8d6e-7f8091a2b3c4",
    "action_id": "AST74830192",
    "action_type": "Reassign",
    "status": "In Progress",
    "company": "Acme",
    "device": {
      "serial_number": "C02X5K3JMD6T",
      "model": "MacBook Pro 14 M5 Pro",
      "type": "Laptop",
      "country": "United States"
    },
    "current_user": {
      "name": "Alex Doe",
      "email": "alex@acme.com",
      "country": "United States",
      "address": "123 Market St, San Francisco, CA 94103",
      "phone": null,
      "notification_date": null
    },
    "new_recipient": {
      "name": "Sam Lee",
      "email": "sam@acme.com",
      "country": "United States",
      "address": "500 Congress Ave, Austin, TX 78701",
      "phone": null,
      "notification_date": null
    },
    "wipe": true,
    "wipe_completed": false,
    "tracking_code": null,
    "tracking_link": null,
    "created_at": "2026-02-19T15:00:00.000Z",
    "updated_at": "2026-02-19T15:00:00.000Z",
    "notes": "Employee change - wipe before reassigning",
    "status_timestamps": { "in_progress": "2026-02-19T15:00:00.000Z" },
    "notification_emails": [],
    "batch_id": null,
    "requested_by": { "name": "Alex Doe", "email": "alex@acme.com" },
    "user_email": "alex@acme.com",
    "comments": []
  }
}