Add Asset
Create a new asset record in the Asset Registry for tracking, assignment, and lifecycle management.
POST
/api/v1/assets/add-assetDescription
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 | Example | Description |
|---|---|---|---|---|
| product_type | string | Yes | Laptop | Type of asset (e.g. Laptop, Mobile). |
| product_name | string | Yes | MacBook Pro 14 | Full product name including model/version. |
| manufacturer | string | Yes | Apple | Brand or manufacturer. |
| serial_number | string | Yes | C02XK1ABCDEF | Device serial number (must be unique). |
| asset_status | string | Yes | 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). |
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
Did this page help you?
Request
curl -X POST https://uat.unduit.com/api-exposed/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": "john.doe@example.com",
"department": "IT",
"location_name": "Headquarters",
"imei": ""
}'Success Response
{
"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"
}
}