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. What a tool returns depends on how you connected. Over OAuth, listings are filtered to what the approving person can see and a recording they cannot open is refused rather than returned; an API key reaches the whole workspace. A tool that writes or deletes is also refused when the connection was not granted that permission at approval time. See Authentication.

Recordings

Most of these tools are 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.
`search`	Takes a `query` string and searches recordings by title and by what was said in them, returning up to 25 of the most recent matches, each with its id, title, watch URL and a snippet of the matching transcript.
`fetch`	Takes a recording `id`, the one `search` returns, and returns the recording’s summary and transcript cut to 20,000 characters in total, along with its watch URL, duration, view count and tags.

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

search and fetch are the two tools the ChatGPT connector specification requires, so they overlap with SearchRecordingsByTitle / SearchRecordingsByTranscript and GetRecording rather than adding anything new. They have no separate REST endpoint, which is why they are not linked above.

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