Objects

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 catalogue of CC0 (open-license) objects alongside org-private objects that admins upload themselves.

Object types

Type	Description
Platform (CC0)	Open-license objects owned by the platform. Reached through the object packs an organization enables, not through its object library
Org-private	Objects uploaded by a specific org, visible only to that org. These are what the object library lists

An organization’s object library shows only its own uploads. Platform objects are grouped into packs that an admin switches on, and appear when building a stage.

Supported formats

Org admins can upload models in any of these formats:

Format	Notes
GLB	Primary format, no conversion needed
USDZ	Converted to GLB post-upload; USDZ retained for AR
OBJ	Converted to GLB on upload
FBX	Converted to GLB on upload
PLY	Scan output. Converted to GLB on upload, carrying vertex color across
STEP / STP	CAD geometry, tessellated to a mesh on upload
ZIP	A bundle: the root model plus the sidecar files it references
.referenceobject	Produced by Holos Capture; the USDZ inside it is extracted automatically

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

Field	Description
`name`	Display name
`tags`	Searchable labels
`source.glb`	Signed download URL for the GLB mesh
`source.usdz`	Signed download URL for the USDZ mesh
`source.representations`	Lighter versions of the same model, each with its own `level`, triangle count, and size. See below
`referenceObjectUrl`	Signed download URL for the `.referenceobject` AR descriptor
`thumbnail`	Signed URL for the thumbnail image
`triangleCount`	Triangles in the full mesh
`approvalStatus`	`pending` · `approved` · `rejected`
`conversionStatus`	`pending` · `processing` · `complete` · `failed`

Representations

A large model carries lighter versions of itself alongside the full one, so a client can fetch what its own triangle budget allows rather than always taking the largest file. source.glb and source.usdz remain the full-fidelity version, and source.representations holds the rest.

Field	Description
`level`	Density. `0` is the full model; higher numbers are coarser
`kind`	`mesh` today. Levels are the same kind of thing at different densities, not different kinds of model
`glb` / `usdz`	Signed download URLs for that level. Either may be `null` when that format was not produced for it
`triangleCount`	Triangles at that level
`fileSizeBytes` / `usdzSizeBytes`	Size of each format at that level. The same triangle count is a very different byte count in each

A client picks the coarsest level under its own budget. Levels are produced only where they earn their place, so a model light enough already carries none.

Endpoints

GET /objects: list objects (platform + org-private)
GET /objects/{objectId}: get an object
PUT /objects/{objectId}: update name, tags, and other editable fields
PUT /objects/{objectId}/approval: set approval status
POST /organizations/{id}/objects/upload: initiate an org object upload

Overview

Concepts

Resources

Object types

Supported formats

Making an object trackable

Key fields

Representations

Endpoints

​Object types

​Supported formats

​Making an object trackable

​Key fields

​Representations

​Endpoints

Object types

Supported formats

Making an object trackable

Key fields

Representations

Endpoints