Lumiere

Read timestamped transcript pages in JSON or WebVTT. Replaces getCaptions. Supports language, speaker labels/entity IDs, original-language word timings, playback ranges, and pagination. Request fewer utterances for a compact excerpt; follow nextCursor for the full transcript. Missing translations fall back to the original language, reported per utterance. Word timings are omitted for translated text. VTT cue ends are inferred, not word-accurate. All times are seconds. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getTranscript

Get timestamped persistent comment feedback for a video. Summary detail is the default; use full only when exact individual comments are required. Use Get Feedback Aggregations instead when only metric breakdowns are needed. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getComments

Get AI-detected entities such as characters, themes, events, and brands for one video. Summary detail is the default; use full only when per-entity moments and timestamps are required. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getContentIntelligence

Get AI-generated moments for one video, optionally constrained to time ranges in seconds. A moment is semantic AI analysis; it is different from an authored scene/chapter and from a low-level visual cut. Use pagination and a limit of at most 100. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getMoments

Get time-bucketed feedback, sentiment, rating, emoji, or retention trends for one video. All time values and bucket intervals are seconds; interval must be at least 5 seconds. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getTrendData

List workspaces authorized for this connection where you are still an active member. Returns IDs and names. Use a workspace ID on subsequent calls when the user establishes a workspace in this conversation. No workspace selection is stored on the server. For explicit cross-workspace discovery, search each listed workspace and label results. Reconnect to authorize additional workspaces.

listTeams

List active videos included in a channel’s sections. Use this to establish the video IDs for channel-wide analysis. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getChannelVideos

List items matching a collection’s saved filters. Collections are dynamic saved searches, unlike static folders. Use offset when totalItems exceeds the returned item count. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getCollectionItems

Browse workspace items without a search term. Replaces getFolderContents. Defaults to direct children of ROOT; set recursive for bounded traversal through folders, channels, and pods. Results are flat with parent IDs. Continue with cursor even when a page is empty. Type filters affect results, not traversal. depthLimited indicates descendants were omitted by maxDepth. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

listItems

List the most recently created or edited active folders, videos, or channels in one workspace. Use itemType folder and limit 1 to find the newest folder, then listItems. orderBy is required: clarify whether recent means created or edited when unclear. This does not track what the user last opened or filter to items created by that user. The search index may briefly lag new changes. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

listRecentItems

List recruitments across the authenticated team, optionally restricted to one item. Defaults to Live, Paused and Auto-Paused; supply statuses to include drafts or completed/cancelled recruitment. Bounded pagination can return an empty page with a nextCursor: continue until nextCursor is null. Status filters use refreshed data when available; inspect freshness for fallback data. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

listRecruitments

List videos in a Video Pod feature attached to a parent video. A Video Pod is an embedded collection of videos, not a channel. If the parent has multiple pods, use featureId to select one. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

getPodVideos

Search Lumiere’s published help articles for product features, settings, and workflows. Returns article markdown and absolute links to the relevant knowledge-base pages.

searchKnowledgeBase

Search the authenticated workspace for videos, channels, or folders by name. Use this to resolve a human-readable name to an item ID before calling item-specific tools. A v-prefixed item can be a video or image; inspect the returned type instead of inferring media type from the ID. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

searchItems

Semantically search AI-generated moments across the authenticated workspace. Use this for concept or meaning-based discovery across videos; results are moments, not authored scenes or visual cuts. Pass teamId when a workspace is established in this conversation. Exact item IDs resolve their workspace automatically. If multiple workspaces are available and no target is established, ask the user using the returned team choices. Team selection applies only to this call.

semanticMomentSearch