Bulk Add Assets
Register up to 200 assets in one request.
POST
/api/v1/assets/bulk-addDescription
Adds multiple assets to Manage App inventory. All rows are validated first; if any fail, none are created.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| assets | array | Yes | Array of asset objects (max 200). |
Each object in assets[]
Fields
| 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). |
Example Request Body
{
"assets": [
{
"product_type": "Laptop",
"product_name": "MacBook Pro 14",
"manufacturer": "Apple",
"serial_number": "C02XK1ABCDEF",
"asset_status": "Ready to Deploy",
"model_number": "MKGP3LL/A",
"condition": "Good"
}
]
}Response
Related Endpoints
Did this page help you?
Request
curl -X POST https://uat.unduit.com/api-exposed/api/v1/assets/bulk-add \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"assets": [
{
"product_type": "Laptop",
"product_name": "MacBook Pro 14",
"manufacturer": "Apple",
"serial_number": "C02XK1ABCDEF",
"asset_status": "Ready to Deploy",
"model_number": "MKGP3LL/A",
"condition": "Good"
}
]
}'Success Response
{
"success": "Assets created successfully",
"data": [
{
"id": 9001,
"serial_number": "C02XK1ABCDEF",
"asset_id": "AST-1001",
"status": "Ready to Deploy",
"company_id": 317
}
]
}