---
title: "Update an Asset"
method: PATCH
path: "/assets/{id}"
tags: ["Assets"]
---

# Update an Asset

`PATCH /assets/{id}`

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

## Request body

- AssetUpdate
  - `name` string — The name of the asset.
  - `type` string, nullable — The asset type (Laptop / Smartphone / etc.).
  - `source` string, nullable — The origin of the asset, describing how it was added to the system.
  - `manufacturer` string, nullable — The manufacturer of the asset.
  - `model` string, nullable — The model of the asset.
  - `serial` string, nullable — The asset's serial number according to the manufacturer.
  - `description` string, nullable — The description of the asset.
  - `isDisabled` boolean — Indicates whether the asset is disabled. When true, automatic inventory updates, monitoring, and all other SysAid Agent capabilities are turned off for the asset.
  - `ownerId` number, 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.
  - `companyId` number, nullable — The unique ID of the company the asset belongs to.
  - `locationId` number, nullable — The unique ID of the asset’s location.
  - `departmentId` number, nullable — The unique ID of the department the asset belongs to.
  - `warrantyExpiration` string, date, nullable — The date when the asset’s warranty expires.
  - `patchManagementEnabled` boolean — Indicates if patch management is enabled for the asset. To learn more, see SysAid Patch Management Guide.
  - `os` OperatingSystem, nullable — Operating System properties.
    - `name` string, nullable — The name of the Operating System.
    - `version` string, nullable — The version of the Operating System.
  - `network` Network, nullable — Network properties.
    - `macAddresses` string[] — The MAC addresses that belong to the asset.
    - `ipAddresses` string[] — The IP addresses of the asset.
  - `customFields` FlattenedCustomColumnsFields
  - `additionalData` string, nullable — Additional data available for the asset.
  - `version` integer, 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.

## Response `200`

Asset updated successfully.

- AssetUpdateResponse
  - `success` boolean
  - `asset` Asset
    - `name` string — The name of the asset.
    - `type` string, nullable — The asset type (Laptop / Smartphone / etc.).
    - `source` string, nullable — The origin of the asset, describing how it was added to the system.
    - `manufacturer` string, nullable — The manufacturer of the asset.
    - `model` string, nullable — The model of the asset.
    - `serial` string, nullable — The asset's serial number according to the manufacturer.
    - `description` string, nullable — The description of the asset.
    - `isDisabled` boolean — Indicates whether the asset is disabled. When true, automatic inventory updates, monitoring, and all other SysAid Agent capabilities are turned off for the asset.
    - `ownerId` number, 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.
    - `companyId` number, nullable — The unique ID of the company the asset belongs to.
    - `locationId` number, nullable — The unique ID of the asset’s location.
    - `departmentId` number, nullable — The unique ID of the department the asset belongs to.
    - `warrantyExpiration` string, date, nullable — The date when the asset’s warranty expires.
    - `patchManagementEnabled` boolean — Indicates if patch management is enabled for the asset. To learn more, see SysAid Patch Management Guide.
    - `os` OperatingSystem, nullable — Operating System properties.
      - `name` string, nullable — The name of the Operating System.
      - `version` string, nullable — The version of the Operating System.
    - `network` Network, nullable — Network properties.
      - `macAddresses` string[] — The MAC addresses that belong to the asset.
      - `ipAddresses` string[] — The IP addresses of the asset.
    - `customFields` FlattenedCustomColumnsFields
    - `additionalData` string, nullable — Additional data available for the asset.
    - `id` string — The asset’s unique ID within SysAid. Cannot be changed.
    - `updateTime` string, date-time, nullable — The timestamp of when the asset was last updated in SysAid in ISO‑8601 format.
    - `version` number, nullable — The asset object version. Cannot be changed.

## Other responses

- `400` — The request was invalid or cannot be served
- `401` — Authentication information is missing or invalid
- `403` — The server understood the request but refuses to authorize it
- `404` — The specified resource was not found
- `409` — The request could not be completed due to a conflict with the current state of the resource. This typically occurs when attempting to create a duplicate resource, update a resource that has been modified by another process, or when business rules prevent the operation.

---

[API](https://skmtc.net/sysaid/apis/sysaid-public-api.md) · [All operations](https://skmtc.net/sysaid/apis/sysaid-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysaid/sysaid-public-api/versions/38a43a1b2981/schema)