Create a highlight on a transcript by specifying start and end timestamps in seconds.

The data entry (referenced by note_id) must contain an audio or video transcript for the highlight to be created. If the entry contains multiple audio/video elements, the first transcript is used.

Tip: to get word-level timestamps for picking start_time and end_time, pair this endpoint with Export data (GET /v1/data/:data_id/export/html). The HTML export wraps each transcript word in a <span> carrying data-monologue-start-time and data-monologue-end-time attributes; the markdown export only includes paragraph-level timestamps. Bounds are snapped to the nearest word, so start_time / end_time returned by Get highlight / List highlights can be sent back here unchanged.

Returns the created highlight.

Permissions

Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.