Assets API
PUT/api/v1/assets/bulk-status
Product availabilityAlgaPSA

Bulk update asset status

Updates the status field for up to 50 assets in the authenticated tenant. The controller validates asset_ids and status with bulkAssetStatusSchema, then calls AssetService.update for each asset_id with { status }. Each update is tenant-scoped by assets.asset_id and assets.tenant and publishes an ASSET_UPDATED event.

RBAC · asset

Request body

Content type: application/json · schema AssetBulkStatusRequest

asset_idsarray of stringRequired
Asset UUIDs from assets.asset_id. Limited to 1 through 50 entries by validation.
min items 1 · max items 50
itemsstring <uuid>
statusstringRequired
New status assigned to every asset in asset_ids.
min length 1

Response body

Success response 200 · schema AssetBulkUpdateResponse

successbooleanRequired
Enum: true
dataobjectRequired
dataarray of AssetResourceRequired
Updated asset rows returned from AssetService.update.
itemsobject
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.
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.
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.
messagestringRequired
Human-readable count of updated assets.
metaobjectRequired
timestampstring <date-time>Required
Response timestamp generated by createApiResponse/createErrorResponse.
versionstringRequired
API response version string.

Response codes

200
Status updated for all requested assets.
400
Request body validation failed.
401
x-api-key is missing at middleware.
403
Authenticated request context lacks permission to update assets when auth wiring is present.
500
Unexpected error.