Updates an existing equipment asset using PATCH semantics.

patch

https://integrationhub.wellsky.io/commands/v4/assets/{serialNumber}

Only the fields provided in the request body are updated; null/omitted fields are left unchanged.
Read-only fields (serialNumber, dispensedTo, residualValue) are silently
ignored if included. An empty patch (no fields provided) is rejected with 400.
When the parent InventoryItem.LogLots is true and a lot-relevant field changes
(or no prior history exists), an AssetLotHistory snapshot is recorded in the same transaction.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

serialNumber

string

required

Defaults to null

The serial number identifying the asset to update.

Query Params

api-version

string

The requested API version

Body Params

The PATCH request body.

Request to update an existing asset using PATCH semantics.
Only the fields provided will be updated; null/omitted fields remain unchanged.

locationId

int64 | null

≥ 1

Optional â€” only updates if provided. LocationId cannot be cleared once set on an asset;

ownershipStatusId

int32 | null

1 to 2147483647

Optional â€” only updates if provided.

lotNumber

string | null

Optional â€” only updates if provided.
LotNumber and LotExpirationDate are paired â€” to clear the lot information, you must clear
BOTH fields in the same request: send LotNumber="" AND
LotExpirationDate=DateTime.MinValue (0001-01-01T00:00:00Z). Clearing only one is rejected.

lotExpirationDate

date-time | null

The lot expiration date in UTC. Date-only â€” any time component will be discarded server-side.
Optional â€” only updates if provided.
To clear the lot information, send DateTime.MinValue (0001-01-01T00:00:00Z) here AND
an empty string for LotNumber in the same request. The two fields are paired and must
be cleared together.

dotCertExpirationDate

date-time | null

The DOT certification expiration date in UTC. Date-only â€” any time component will be discarded server-side.
Optional â€” only updates if provided.
To clear the DOT certification expiration date, send DateTime.MinValue (0001-01-01T00:00:00Z).

notes

string | null

Optional notes about the asset. To clear, send an empty string "".

purchaseDate

date-time | null

The purchase date of the asset in UTC. Date-only â€” any time component will be discarded server-side.
Optional â€” only updates if provided.
To clear the purchase date, send DateTime.MinValue (0001-01-01T00:00:00Z).

acquisitionCost

double | null

≥ 0

Optional â€” only updates if provided. Must be non-negative.

uniqueDeviceIdentifier

string | null

Optional â€” only updates if provided. To clear, send an empty string "".

assetNumber

string | null

Optional. The asset number for this asset. If provided and the asset does not already
have an AssetNumber code, one is created (AssetCodeType=2); if it does, the existing
code is updated to this value.

modifiedBy

string | null

Optional username of the person performing the update.
If provided, must reference an active user. If omitted, defaults to the system integration user.

Headers

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Responses

200OK

400Bad Request

404Not Found

500Internal Server Error