Tools

You do not call these by name. Ask for what you want and the assistant picks the tool. The list is here so you know what is possible, and so you can nudge an assistant that reaches for the wrong thing. Every tool takes an optional workspace argument, the subdomain of a connected workspace. Left out, it uses the workspace the connection was set up with.

Recordings

Backed by the recordings endpoints. For field level detail, see the API reference.

Tool	What it does
`ListRecordings`	Lists recordings with optional filters and pagination.
`GetRecording`	Gets full details of one recording by id.
`SearchRecordingsByTitle`	Exact or partial title search across recordings.
`SearchRecordingsByTranscript`	Full text search across transcript content.
`UpdateRecording`	Updates a recording’s title, summary, or tags.
`MoveRecordingToFolder`	Moves a recording into a folder, or out of its current one.
`DeleteRecording`	Permanently deletes a recording and everything derived from it.

DeleteRecording cannot be undone. Assistants are told it is destructive, but confirm what is about to be deleted before you approve the call.

Transcripts and chapters

Tool	What it does
`GetTranscript`	Gets the full transcript with timestamps.
`GetTranscriptStatus`	Reports whether a transcript exists and how generation is going.
`TriggerTranscriptGeneration`	Starts or restarts transcript generation.
`GetChapters`	Gets the auto generated chapters.
`GetChapterStatus`	Reports whether chapters exist and how generation is going.
`TriggerChapterGeneration`	Starts chapter generation.

Tool	What it does
`GetShareLink`	Gets the public share link, and whether it is expired or access controlled.
`GetEmbedCode`	Gets the HTML embed code for a recording.
`GetDownloadUrl`	Gets a presigned download URL, valid for a limited time.
`TriggerMp4Generation`	Starts preparing the downloadable MP4.
`GetScreenshot`	Captures a still frame at a timestamp and returns the image inline.

Folders and tags

Tool	What it does
`ListFolders`	Lists the recording folders in the workspace.
`CreateFolder`	Creates a folder, optionally nested under another.
`ListTags`	Lists the recording tags in the workspace.

Calls to action

Tool	What it does
`ListCtas`	Lists the CTA buttons configured on a recording.
`CreateCta`	Adds a CTA button to a recording for a time range.

Analytics

Tool	What it does
`GetOrganizationAnalytics`	Aggregate recording and view counts across the workspace.
`GetRecordingAnalytics`	View analytics for one recording.

Recording requests

Tool	What it does
`CreateRecordingRequest`	Creates a recording request for an active user in the workspace.

Public recordings

These reach recordings in other workspaces, and only when the recording is publicly accessible with no sign in required. They return less than their workspace counterparts, and they respect what the owner allowed, so a transcript or a download may be unavailable.

Tool	What it does
`GetPublicRecordingDetails`	Gets details of a publicly accessible recording.
`GetPublicTranscript`	Gets its transcript with timestamps.
`GetPublicChapters`	Gets its chapters.
`GetPublicShareLink`	Gets its share link.
`GetPublicEmbedCode`	Gets its embed code.
`GetPublicDownloadUrl`	Gets a presigned download URL for it.
`GetPublicScreenshot`	Captures a still frame from it at a timestamp.

Workspaces

Tool	What it does
`ListWorkspaces`	Lists the workspaces this connection can reach, with their subdomains.

Getting Started

Reference

Recordings

Transcripts and chapters

Folders and tags

Calls to action

Analytics

Recording requests

Public recordings

Workspaces

​Recordings

​Transcripts and chapters

​Sharing and media

​Folders and tags

​Calls to action

​Analytics

​Recording requests

​Public recordings

​Workspaces

Recordings

Transcripts and chapters

Sharing and media

Folders and tags

Calls to action

Analytics

Recording requests

Public recordings

Workspaces