Assets API
PUT/api/v1/assets/{id}
Product availabilityAlgaPSA

Update asset

Partially updates base asset fields for the authenticated tenant. Custom attributes are validated against the next asset type when asset_type changes, then merged into the stored map so omitted keys remain. Required custom fields cannot be blanked. Unknown asset_type slugs and invalid attributes return 400.

RBAC · asset

Path parameters

idstring <uuid>Required
Asset UUID from assets.asset_id.

Request body

Content type: application/json · schema AssetUpdateData

client_idstring <uuid>
Client UUID to assign to the asset.
asset_typestring
Must be a built-in slug or registered custom slug; unknown slugs return 400.
asset_tagstring
Tenant-specific asset tag.
min length 1 · max length 255
namestring
Asset name.
min length 1 · max length 255
statusstring
Asset status.
min length 1
location_idstring <uuid>Nullable
Client_locations.location_id link. Pass null to clear.
locationstring
Free-text asset location.
serial_numberstring
Serial number.
purchase_datestring <date-time>
Purchase date/time.
warranty_end_datestring <date-time>
Warranty end date/time.
manufacturerstringNullable
Hardware make. RMM sync fills it when the provider reports one.
max length 255
modelstringNullable
Hardware model. A first-class column, not a system_info lookup.
max length 255
vendor_idstring <uuid>Nullable
Supplier; an inventory vendors.vendor_id of this tenant.
purchase_costintegerNullable
Purchase cost in minor units (cents).
purchase_cost_currencystringNullable
ISO currency code; defaults to the tenant currency when a cost is written without one.
min length 3 · max length 3
order_numberstringNullable
Purchase order number.
max length 255
billing_profile_idstring <uuid>Nullable
Billing profile for work on this device. Must belong to the asset client and be active; cleared when the client changes.
attributesobject
Values for a custom asset type's fields, keyed by each field's key in the tenant asset type registry fields_schema. On create, required fields must be present; on update, provided keys merge into the stored map, omitted keys remain, and required fields cannot be blanked. Other keys such as integration namespaces are stored as-is. Built-in asset types accept the map without schema validation.
extension_dataobject

Response body

Success response 200 · schema AssetResourceResponse

successbooleanRequired
Enum: true
dataobjectRequired
dataobjectRequired
asset_idstring <uuid>Required
Primary key from assets.asset_id.
client_idstring <uuid>Required
Client UUID from assets.client_id.
asset_typestringRequired
Asset type stored in assets.asset_type.
asset_tagstringRequired
Tenant-specific asset tag.
namestringRequired
Asset display name.
statusstringRequired
Asset status.
location_idstring <uuid>Nullable
Client_locations.location_id link, when set.
locationstringNullable
Asset location, when recorded.
serial_numberstringNullable
Asset serial number, when recorded.
purchase_datestringNullable
Asset purchase date from assets.purchase_date.
warranty_end_datestringNullable
Warranty end date from assets.warranty_end_date.
contact_name_idstring <uuid>Nullable
The contact this asset is assigned to; drives portal contact-scoped visibility.
manufacturerstringNullable
Hardware make from assets.manufacturer.
modelstringNullable
Hardware model from assets.model.
vendor_idstring <uuid>Nullable
Supplier from assets.vendor_id (inventory vendors).
vendor_namestringNullable
Supplier name from the joined vendors row.
purchase_costintegerNullable
Purchase cost in minor units (cents).
purchase_cost_currencystringNullable
ISO currency code of purchase_cost.
order_numberstringNullable
Purchase order number from assets.order_number.
billing_profile_idstring <uuid>Nullable
Billing profile for work on this device; null means the location default or the client default applies.
created_atstring <date-time>Required
Asset creation timestamp.
updated_atstring <date-time>Required
Asset last update timestamp.
tenantstring <uuid>Required
Tenant UUID from assets.tenant; filtered to the authenticated request context.
attributesobject
client_namestring
Client name selected from the joined clients table.
warranty_statusstring
Computed from warranty_end_date by SQL CASE expression.
Enum: no_warrantyexpiredexpiring_soonactive
maintenance_statusstring
Optional computed maintenance status when present in service results.
extension_dataobject
relationshipsarray of object
Related asset rows included by getWithDetails after create.
itemsobject
documentsarray of object
Associated document rows included by getWithDetails after create.
itemsobject
maintenance_schedulesarray of object
Maintenance schedule rows included by getWithDetails after create.
itemsobject
_linksobject
HATEOAS links generated from the asset_id.
metaobjectRequired
timestampstring <date-time>Required
Response timestamp generated by createApiResponse/createErrorResponse.
versionstringRequired
API response version string.

Response codes

200
Asset updated successfully.
400
Request validation failed, asset_type is not registered, custom attributes are invalid, or the database rejected an invalid reference.
401
x-api-key is missing at middleware.
403
Authenticated request context lacks permission to update assets when auth wiring is present.
404
Intended not-found response for missing assets; the current controller path may surface this as 500.
409
Database unique constraint conflict, such as a duplicate asset tag if enforced by schema.
500
Unexpected error, including null asset result handling.