Skip to main content
A HolosObject is a 3D model that can be tracked during a capture session, placed in a Holos Learn course, or both. The platform maintains a library of ~3,600 CC0 (open-license) objects alongside org-private objects that admins upload themselves.

​
Object types

​
Supported formats

Org admins can upload models in any of these formats: All uploads automatically produce a GLB for web preview and a USDZ for AR tracking where not already provided.

​
Making an object trackable

For an object to be tracked during a capture session, it needs a .referenceobject file — an Apple ML-trained descriptor of its geometry, generated from the USDZ mesh. The platform handles this as a processing request. When an admin links a non-trackable object to a skill, a request is automatically filed. The Holos team processes it and uploads the resulting .referenceobject file.

​
Key fields

​
Endpoints

  • GET /api/org/:orgId/objects — list objects (platform + org-private)
  • GET /api/org/:orgId/objects/by-ids/:ids — batch fetch by _id
  • POST /api/org/:orgId/objects/upload — initiate an org object upload
  • PATCH /api/org/:orgId/objects/:objectId — update name, tags, approval status