v1

latestOpenAPI 3.1.02026-07-2489171167.4 KB

Assets

Update an Asset

Update the details of an existing asset. Existing fields will be overwritten with newly provided information.

patch/assets/{id}

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.

versioninteger required

The version number of the resource used for optimistic locking. This value must be provided when updating a resource to prevent conflicts caused by concurrent modifications. If the provided version does not match the current version on the server, the update will be rejected to ensure data consistency.

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",
  "version": 13
}

Response

Asset updated successfully.

successboolean

Example response

{
  "success": true,
  "asset": {
    "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",
    "id": "MSI-123",
    "updateTime": "2025-07-27T18:09:55Z",
    "version": 1
  }
}