Update asset

patch

https://iris.trackunit.com/api/asset/v2beta1/assets/{assetId}

This API request can be used to update an asset using a partial update approach through the use of JSON Patch defined in RFC 6902.

Path Params

assetId

uuid

required

ID of the asset

Body Params

assetType

string

enum

Type	Description
Machine	Battery or fuel-powered heavy assets controlled by an operator.
Vehicle	Heavy assets used for transporting people or goods, especially on land.
Gateway	Serve as a communication managers between bluetooth tags and the Iris platform.
Attachment	Items added to machines or equipment for enhanced functionality.
Tool	Small powered assets like impact drills or high-pressure washers.
Equipment	Non-powered assets like wheelbarrows or containers.
Other	Assets that do not fit into the defined categories.

Allowed:

brand

string

length between 0 and 256

The brand of the asset.

externalReference

string

length between 0 and 100

An external reference on the asset that can be used to store the identifier from other systems such as ERPs.

model

string

length between 0 and 256

The model of the asset.

name

string

length between 0 and 127

The name of the asset.

productionDate

date

An optional field to specify the exact production date of the asset in the format YYYY-MM-DD when more precision is needed.
Minimum allowed year for production date is 1900. Maximum allowed year for production date is current year plus one.
For AssetType=MACHINE, it is derived if only productionYear is set. The year of Production Date must match Production Year if both are provided together.
Updating one while deleting the other is an error.

productionYear

int32

The year the asset was produced. Minimum allowed production year is 1900. Maximum allowed production year is current year plus one.
For AssetType=MACHINE, it is derived if only productionDate is set. Production Year must match the year of Production Date if both are provided together.
Updating one while deleting the other is an error.

serialNumber

string

length between 0 and 100

The asset serial number (e.g VIN).

type

string

length between 0 and 50

The type of the asset (excavator, lift, bucket etc.)

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Asset was successfully updated.

401Invalid or missing bearer token in Authorization header

403User not allowed to make this request. These are the possible error codes from this API: only_owner_of_the_asset_can_edit_given_fields Fields like : assetType, type, model, brand, productionYear, serialNumber can be modified only by the owner of the asset.

404Resource not found. These are the possible error codes from this API: asset_not_found Asset was not found by given ID.

500Internal server error