Sign in

v1

latestOpenAPI 3.1.02026-07-2489171167.4 KB
Assets

Create a New Asset

Create a new asset in your SysAid account.

post/assets

Request body

namestring

The name of the asset.

typestring nullable

The asset type (Laptop / Smartphone / etc.).

sourcestring nullable

The origin of the asset, describing how it was added to the system.

manufacturerstring nullable

The manufacturer of the asset.

modelstring nullable

The model of the asset.

serialstring nullable

The asset's serial number according to the manufacturer.

descriptionstring nullable

The description of the asset.

isDisabledboolean

Indicates whether the asset is disabled. When true, automatic inventory updates, monitoring, and all other SysAid Agent capabilities are turned off for the asset.

ownerIdnumber nullable

The unique ID of the user who owns the asset.

ownership'personal' | 'company' nullable

Defines who is the official owner of the asset - the employee or the company.

companyIdnumber nullable

The unique ID of the company the asset belongs to.

locationIdnumber nullable

The unique ID of the asset’s location.

departmentIdnumber nullable

The unique ID of the department the asset belongs to.

warrantyExpirationstring date nullable

The date when the asset’s warranty expires.

patchManagementEnabledboolean

Indicates if patch management is enabled for the asset. To learn more, see SysAid Patch Management Guide.

customFieldsFlattenedCustomColumnsFields
additionalDatastring nullable

Additional data available for the asset.

Example request

{
  "name": "KATANA-GF66",
  "type": "laptop",
  "source": "agent",
  "manufacturer": "MSI",
  "model": "GF66 11UG-871",
  "serial": "SN1A2B3C4",
  "description": "Very cool asset!",
  "ownerId": 10293,
  "ownership": "personal",
  "companyId": 7,
  "locationId": 14,
  "departmentId": 3,
  "warrantyExpiration": "2026-05-13",
  "patchManagementEnabled": true,
  "os": {
    "name": "Windows",
    "version": "11 Pro 24H2"
  },
  "network": {
    "macAddresses": [
      "18:3D:A2:55:67:10",
      "18:3D:A2:55:67:11"
    ],
    "ipAddresses": [
      "10.178.3.44",
      "10.178.3.45"
    ]
  },
  "customFields": {
    "cust_col1": "val1",
    "cust_col21": "val2"
  },
  "additionalData": "Uptime (in seconds): 23945770\nUser domain: EXAMPLE"
}

Response

Asset created successfully.

successboolean
idstring

Example response

{
  "success": true,
  "id": "MSI-123"
}