Captures - Holos Docs

A Capture is a recorded session from the Holos Capture app. It contains synchronized streams of spatial data (video, pose, hand tracking, object tracking, and transcription), packaged and uploaded to the platform for review, approval, and output generation.

Key fields

Field	Description
`captureId`	Unique within the org
`title`	Display name (editable after upload)
`member_id`	The member who recorded it
`tracked_objects`	Objects observed during the session, with resolved `_id` references
`transcript`	Timestamped speech-to-text segments
`location`	GPS coordinates at time of recording
`device`	Device model and OS version
`start_wall`	Wall-clock timestamp of when recording started
`tags`	Free-form labels
`thumbnailUrl`	Presigned URL for the session thumbnail

Lifecycle

Captures are uploaded from the Holos Capture app. Once processed, they appear in the dashboard with all modality data available. Captures can be linked to procedures, where each one either corroborates the procedure’s steps or raises a proposal for review.

Transcript overrides

Individual transcript segments can be edited after upload. Edits are stored as override records and applied on read; the original transcript is preserved.

Endpoints

GET /captures: list captures
GET /captures/{captureId}: get a capture
GET /captures/{captureId}/transcript: its timecoded transcript
GET /captures/{captureId}/steps: its extracted procedure steps
GET /captures/{captureId}/download-url: a signed URL for the recording
POST /captures/{captureId}/export-hdf5 and GET /captures/{captureId}/export-hdf5: the capture as one HDF5 file, written by a worker job; see Export as HDF5