Open Inventory / Docs
EndpunkteSpatial roomsRoom scansScanidAssetsKind

Attach or replace a photorealistic room derivative

Die API läuft auf deiner Anwendungsinstanz. Schemas und Feldnamen stammen unverändert aus der OpenAPI-Spezifikation. Browsergebundene Aufrufe benötigen eine Sitzung auf der Instanz.

PUT
/room-scans/{scanId}/assets/{kind}

Accepts raw GLB bytes for textured_mesh or raw bounded PLY bytes for gaussian_splat. Vertices must already use the scan's shared ARKit world frame (metres, right-handed, Y-up); no alignment transform is inferred. The web client renders PLY as a bounded point-splat preview; textured GLB is the full photorealistic path. This mutable enrichment does not change the idempotent identity of the original room capture. Content-Length is required before the server buffers the body.

Authentifizierung

bearerAuth
headerAuthentifizierungBearer <inv_ token>

Pfadparameter

scanId*string
Formatuuid
kind*string
Mögliche Werte"world_map""model_usdz""structure_model""guide_image""textured_mesh""gaussian_splat"

Header-Parameter

X-Organization-ID?string

Organization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.

Formatuuid

Anfrageinhalt

body*file
Formatbinary
Längelength <= 80000000

Antwortinhalt

Existing derivative replaced

Beispielanfrage
curl -X PUT 'https://inventory.example.com/api/v1/room-scans/497f6eca-6276-4993-bfeb-53cbbbba6f08/assets/world_map'
Beispielantwort
Leer