An InventoryAsset represents a physical asset — such as a desk, chair, monitor, printer, or other piece of equipment — that a location can track and optionally assign to customers.Each asset belongs to a single location (BusinessId) and can be assigned to a specific scope via AssignToType:
AssignToType value
Meaning
1 (Location)
Assigned to the location generally, not tied to a specific resource or floor-plan item
2 (Resource)
Linked to a bookable resource (e.g. a specific meeting room) via ResourceId
3 (FloorPlanItem)
Linked to a floor-plan desk via FloorPlanDeskId
Assets may also be assigned to one or more coworkers. The read-only fields CoworkerIds, CoworkerFullNames, CoworkerStartDates, and CoworkerEndDates reflect current assignments. To manage coworker-level assignments, use the CoworkerInventoryAsset entity instead.
This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header.
The authenticated user must be a full unrestricted administrator or have the InventoryAsset-List role.
The list of InventoryAsset records matching the query. See the Get one InventoryAsset endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each InventoryAsset. The following fields are not included in the Records[] response: AssignToType.To get all fields, fetch the full record using the Get one InventoryAsset endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.