Update Asset

Partially update an existing asset record.

PATCH

/api/v1/assets/{id}

Description

Updates only fields sent in the body. If changing asset_status to a deployable status, assign_to_email is required.

Header	Value	Required
Authorization	Bearer <access_token>	Yes
Content-Type	application/json	Yes

Parameter	Type	Required	Description
id	string	Yes	Asset identifier.

Parameter	Type	Required	Example	Description
product_type	string	No	Laptop	Type of asset (e.g. Laptop, Mobile).
product_name	string	No	MacBook Pro 14	Full product name including model/version.
manufacturer	string	No	Apple	Brand or manufacturer.
serial_number	string	No	C02XK1ABCDEF	Device serial number (must be unique).
asset_status	string	No	In Use	Status name (e.g. In Use, Ready to Deploy).
model_number	string	No	A2338	Manufacturer model identifier.
sku	string	No	MBP-16-2021	Stock keeping unit.
asset_id	string	No	IT-1234-ABCD	Customer asset ID.
condition	string	No	Good	New, Good, Fair, or Poor.
purchase_date	string	No	2023-01-15	Purchase date (YYYY-MM-DD).
purchase_cost	number	No	1999.99	Acquisition cost.
purchase_type	string	No	Leased	Purchased or Leased.
warranty_start	string	No	2023-01-15	Warranty start date.
warranty_expire	string	No	2025-01-14	Warranty end date (must be after warranty_start).
warranty_type	string	No	AppleCare	Warranty coverage type.
assign_to_email	string	No	john.doe@example.com	Required only when status type is deployed.
department	string	No	IT	Department name.
location_name	string	No	Headquarters	Physical location of the asset.
imei	string	No		IMEI (mobile devices only).

{
  "asset_status": "In Use",
  "assign_to_email": "john.doe@example.com",
  "condition": "Good"
}