Add Asset

Create a new asset record in the Asset Registry for tracking, assignment, and lifecycle management.

POST

/api/v1/assets/add-asset

Description

This endpoint allows you to add a new asset to the Manage App inventory system. It is typically used by IT administrators or asset managers to register company equipment such as laptops, desktops, phones, or other devices.

Assets added through this endpoint will be available for tracking, assignment, warranty monitoring, and lifecycle management in the application.

When adding an asset, the email field is mandatory only if the status type is set to "deployed". For all other status types, including "undeployed", "deployable", "archived", and "pending", the email field is not required.

Request

Request Body Parameters

Parameter	Type	Required	Description
product_type	string	Yes	Type of asset being added (e.g., Laptop, Mobile).
product_name	string	Yes	Full product name including model/version.
manufacturer	string	Yes	Brand or manufacturer of the device.
serial_number	string	Yes	Device serial number (must be unique).
asset_status	string	Yes	Current state of the asset.
asset_id	string	Yes	Unique internal asset identifier.
condition	string	Yes	Condition of the asset (New, Good, Fair, Damaged).
purchase_date	date	Yes	Purchase or lease date (YYYY-MM-DD).
purchase_type	string	Yes	Acquisition method (Purchased, Leased).
model_number	string	No	Model identifier from the manufacturer.
sku	string	No	Internal stock keeping unit ID.
purchase_cost	number	No	Cost of the asset at acquisition.
warranty_start	date	No	Warranty start date.
warranty_expire	date	No	Warranty end date.
warranty_type	string	No	Warranty coverage type (e.g., AppleCare).
assign_to_email	string	No	Required only when status type is deployed.
department	string	No	Department responsible for the asset.
location_name	string	No	Physical or office location of the asset.
imei	string	No	IMEI number (for phones/tablets only).

Response Fields

Field	Type	Description
success	string	Operation status message.
data	object	Created asset record object.
data.id	number	Created asset database ID.
data.asset_number	string	Generated unique asset number.

Related Endpoints

Assets List

Retrieve a paginated list of assets

Asset Detail

Get complete details for a specific asset

Did this page help you?

Request

curl -X POST https://dev-api.unduit.com/api/v1/assets/add-asset \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "product_type": "Laptop",
    "product_name": "MacBook Pro 2",
    "manufacturer": "Apple",
    "serial_number": "2322334e234",
    "asset_status": "in use",
    "model_number": "A23338",
    "sku": "MBP-16-2021",
    "asset_id": "IT-12342443122ddes341234",
    "condition": "Good",
    "purchase_date": "2023-01-15",
    "purchase_cost": 1999.99,
    "purchase_type": "Leased",
    "warranty_start": "2023-01-15",
    "warranty_expire": "2025-01-14",
    "warranty_type": "AppleCare",
    "assign_to_email": "[email protected]",
    "department": "IT",
    "location_name": "Headquarters",
    "imei": ""
  }'

Success Response (200)

{
  "success": "Asset created successfully",
  "data": {
    "id": 24546,
    "company_id": 317,
    "user_id": 0,
    "purchase_id": 0,
    "product_type_id": 4108,
    "product_category_id": 1,
    "model_id": 1196,
    "asset_id": "",
    "customer_asset_id": "IT-112342443E1234",
    "serial_number": "2312E2334E234",
    "model_number": "A23338",
    "status_id": 60,
    "condition": "Good",
    "purchase_date": "2023-01-15",
    "price": 1999.99,
    "purchase_type": 1,
    "warranty_start": "2023-01-15",
    "warranty_expire": "2025-01-14",
    "warranty_type": "AppleCare",
    "assign_to": 8019,
    "department_id": 88,
    "asset_location_beta": 132,
    "imei": "",
    "imei2": "",
    "asset_assign_date": "",
    "vendor_id": 0,
    "currency_code": "",
    "currency_symbol": "",
    "sku": "MBP-16-2021",
    "address_1": "",
    "city": "",
    "state": "",
    "zip": "",
    "is_old": 0,
    "created_at": "2025-06-02 04:48:25",
    "updatedAt": "2025-06-02T04:48:25.221Z",
    "createdAt": "2025-06-02T04:48:25.216Z",
    "asset_number": "2454620250602044825"
  }
}