Create a device action

Device Actions: Track device lifecycle actions such as retrievals, transfers, wipes, and deployments.

Endpoint7 params

Parameters

Name	Type	Required	Description
`action_type`	string	yes	The type of device action.
`serial_number`	string	yes	Serial number of the device in your inventory. Device details are auto-populated.
`current_user`	object	no	Current holder of the device (name and email required when provided). Required when the device is in use; optional for devices stored in the warehouse, since there is no current holder. Accepts an optional notification_date (YYYY-MM-DD): when set to a future date, the scheduling link is sent to this person on that date instead of immediately.
`new_recipient`	object	no	New recipient (required for Assign and Reassign). Must include name and email. Accepts an optional notification_date (YYYY-MM-DD): when set to a future date, the scheduling link is sent to this person on that date instead of immediately.
`wipe`	boolean	no	Whether to wipe the device (for Store actions)
`notes`	string	no	Additional notes for the action
`notification_emails`	string[]	no	Additional emails to notify

javascript

const response = await fetch(`https://api.quipteams.com/api/v1/device-actions`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "action_type": "Store",
    "serial_number": "C02X9876WXYZ",
    "current_user": {
      "name": "John Doe",
      "email": "john@acme.com",
      "country": "United States",
      "address": "123 Main St",
      "phone": "+1-555-0100",
      "notification_date": "2026-03-15"
    },
    "wipe": true,
    "notes": "Employee leaving March 15th",
    "notification_emails": [
      "it@acme.com"
    ]
  }),
});

const { data } = await response.json();
console.log(data);

Example Request Body

json

{
  "action_type": "Store",
  "serial_number": "C02X9876WXYZ",
  "current_user": {
    "name": "John Doe",
    "email": "john@acme.com",
    "country": "United States",
    "address": "123 Main St",
    "phone": "+1-555-0100",
    "notification_date": "2026-03-15"
  },
  "wipe": true,
  "notes": "Employee leaving March 15th",
  "notification_emails": [
    "it@acme.com"
  ]
}

Response

json

{
  "data": {
    "id": "da-uuid-002",
    "action_id": "AST34567890",
    "action_type": "Store",
    "status": "In Progress",
    "company": "Acme Corp",
    "device": {
      "serial_number": "C02X9876WXYZ",
      "model": "MacBook Pro 14\"",
      "type": "Laptop",
      "country": "United States"
    },
    "current_user": {
      "name": "John Doe",
      "email": "john@acme.com",
      "country": "United States",
      "address": "123 Main St",
      "phone": "+1-555-0100",
      "notification_date": "2026-03-15"
    },
    "new_recipient": null,
    "wipe": true,
    "wipe_completed": false,
    "tracking_code": null,
    "tracking_link": null,
    "notes": "Employee leaving March 15th",
    "status_timestamps": {},
    "notification_emails": [
      "it@acme.com"
    ],
    "batch_id": null,
    "requested_by": {
      "name": "API",
      "email": "john@acme.com"
    },
    "user_email": "john@acme.com",
    "comments": [],
    "created_at": "2026-03-07T10:00:00.000Z",
    "updated_at": "2026-03-07T10:00:00.000Z"
  }
}