Create assets

Creates one or more manually managed assets

Create Assets

post

Create assets efficiently from array payload

Authorizations

AuthorizationstringRequired

Harmony access key, sent as Authorization: AccessKey <your-key>. Create keys in Settings > Access Keys. The tenant is resolved from the key.

Body

Responses

200

Successful Response

application/json

total_assetsintegerRequired

successful_insertsintegerRequired

successful_updatesintegerRequired

failed_insertsintegerRequired

422

Validation Error

application/json

post/api/v1/assets

POST /asset-management/api/v1/assets HTTP/1.1
Host: api.harmony.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 371

{
  "assets": [
    {
      "name": "text",
      "asset_type": "LAPTOP",
      "manufacturer": "text",
      "serial_number": "text",
      "model": "text",
      "ownership": "COMPANY_OWNED",
      "mdm_status": "ACTIVE",
      "status": "in_stock",
      "for_sale": false,
      "location_manual": "text",
      "note": "text",
      "purchase_number": "text",
      "quantity": 1,
      "custom_fields": {
        "ANY_ADDITIONAL_PROPERTY": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "assignee": "text"
    }
  ]
}

{
  "total_assets": 1,
  "successful_inserts": 1,
  "successful_updates": 1,
  "failed_inserts": 1,
  "assignee_failures": [
    {
      "name": "text",
      "serial_number": "text",
      "assignee": "text",
      "reason": "ambiguous_name"
    }
  ],
  "custom_field_violations": [
    {
      "field_id": "text",
      "field_label": "text",
      "code": "text",
      "message": "text",
      "context": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}