The Wistia connector lets your AI agent act in each user's Wistia account. Each user connects their own Wistia access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 15 · 12 · 315 read12 write3 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Wistia connection
In AgentKit > Connections, create a Wistia connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'wistia'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Wistia:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'wistia_account_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "wistia"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Wistia:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="wistia_account_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Wistia credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolwistia_account_getGet a summary of the Wistia account.Read-onlyGet Account
Get a summary of the Wistia account. Returns id, name, url, media_count, video_limit, folder_count and channel_count. Use this to confirm which account the connection uses.
Inputs
This tool takes no inputs.
wistia_account_stats_getGet account-wide viewing statistics.Read-onlyGet Account Stats
Get account-wide viewing statistics. Returns load_count, play_count and hours_watched for all media in the account. Use this for overall performance. Use wistia_media_stats_get for one video.
Inputs
This tool takes no inputs.
wistia_background_job_status_getGet the status of an asynchronous job such as a URL import, bulk move, archive, restore or tagging.Read-onlyGet Background Job Status
Get the status of an asynchronous job such as a URL import, bulk move, archive, restore or tagging. Returns background_job_status with id, hashed_id and status (queued, started, finished or failed). Use this after wistia_media_import_url, wistia_medias_move, wistia_medias_archive, wistia_medias_restore or wistia_media_tags_add.
Inputs
backgroundJobStatusIdstringrequired- ID of the background job, from the background_job_status returned by import, move, archive, restore or tag tools. Example: 98765432
wistia_channels_listList the account's Channels (video series hubs).Read-onlyList Channels
List the account's Channels (video series hubs). Returns channels with hashed_id, name, description, media_count and created/updated times. Use this to find a channel.
Inputs
pageinteger- Page number to return, starting at 1. Example: 1
per_pageinteger- Items per page (Wistia's default is 10, maximum 100). Example: 25
sort_bystring- Sort field: created, id, updated or name. Example: updatedone of
createdidupdatedname sort_directioninteger- Sort direction: 1 for ascending (default), 0 for descending. Example: 0one of
01
wistia_folder_getGet one folder.Read-onlyGet Folder
Get one folder. Returns hashed_id, name, description, media_count, public and anonymous access settings, and its medias. Use wistia_folders_list to find the ID.
Inputs
idstringrequired- Hashed ID of the folder (previously called project). Get it from wistia_folders_list. Example: 4d23503f70
wistia_folders_listList folders (formerly projects) in the account.Read-onlyList Folders
List folders (formerly projects) in the account. Returns folders with hashed_id, name, description, media_count, public and created/updated times. Use this to find a folder ID for media tools.
Inputs
hashed_idsarray- Only these folders. Example: ["4d23503f70"]
pageinteger- Page number to return, starting at 1. Example: 1
per_pageinteger- Items per page (Wistia's default is 10, maximum 100). Example: 25
sort_bystring- Sort field: name, created, updated, mediaCount or id. Example: updatedone of
namecreatedupdatedmediaCountid sort_directioninteger- Sort direction: 1 for ascending (default), 0 for descending. Example: 0one of
01
wistia_media_captions_getGet a media's captions (transcript) in one language.Read-onlyGet Media Captions
Get a media's captions (transcript) in one language. Returns language, text and, with include, time-coded segments or speaker-turn segments. Use this to read a video's transcript.
Inputs
languageCodestringrequired- Three-letter ISO 639-2 language code, for example eng, fre or spa. Example: eng
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
includestring- segments for time-coded cues, or diarized_segments for speaker-turn segments. Example: segmentsone of
segmentsdiarized_segments
wistia_media_captions_listList the caption tracks of a media.Read-onlyList Media Captions
List the caption tracks of a media. Returns captions with language, english_name, native_name, is_draft and text. Use this to see which languages exist. Use wistia_media_captions_get for one language with timings.
Inputs
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
wistia_media_engagement_getGet the engagement graph for one video.Read-onlyGet Media Engagement
Get the engagement graph for one video. Returns engagement (overall percentage) and engagement_data, the share of viewers still watching at each point, plus rewatch_data. Use this to see where viewers drop off. Use wistia_media_stats_get for totals.
Inputs
mediaIdstringrequired- Hashed ID (or numeric ID) of the video. Example: abc123def4
wistia_media_getGet one media by hashed ID.Read-onlyGet Media
Get one media by hashed ID. Returns hashed_id, name, description, type, duration, status, assets (file URLs per rendition), thumbnail, folder, tags and embed details. Use this for a media's details and file URLs. Use wistia_media_stats_get for its viewing stats.
Inputs
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
includestring- Set to speakers to include transcript speaker assignments. Example: speakersone of
speakers
wistia_media_stats_getGet viewing statistics for one video.Read-onlyGet Media Stats
Get viewing statistics for one video. Returns load_count, play_count, play_rate, hours_watched, engagement and visitors. Use this for a video's performance. Use wistia_media_engagement_get for its drop-off curve.
Inputs
mediaIdstringrequired- Hashed ID (or numeric ID) of the video. Example: abc123def4
wistia_medias_listList media (videos, audio, images and documents) in the account, filtered by folder, name, type, tags or archived state.Read-onlyList Media
List media (videos, audio, images and documents) in the account, filtered by folder, name, type, tags or archived state. Returns an array of media with hashed_id, name, type, duration, status, thumbnail, folder, tags and created/updated times. Use this to find a media's hashed ID. Use wistia_search for free-text search across media, folders and channels.
Inputs
archivedboolean- true for only archived media, false for only active media. Example: false
folder_idstring- Only media in this folder (hashed ID). Example: 4d23503f70
hashed_idsarray- Only these media (batch fetch by hashed ID). Example: ["abc123def4", "xyz789ghi0"]
namestring- Only media whose name exactly matches. Example: Product Demo
pageinteger- Page number to return, starting at 1. Example: 1
per_pageinteger- Items per page (Wistia's default is 10, maximum 100). Example: 25
sort_bystring- Sort field: name, created, updated or position. Example: createdone of
namecreatedupdatedposition sort_directioninteger- Sort direction: 1 for ascending (default), 0 for descending. Example: 0one of
01 tagsarray- Only media that have all of these tag names. Example: ["webinar", "2026"]
typestring- Only this media type: Video, Audio, Image, PdfDocument, MicrosoftOfficeDocument, Swf or UnknownType. Example: Videoone of
VideoAudioImagePdfDocumentMicrosoftOfficeDocumentSwfUnknownType
wistia_searchSearch across media, folders, subfolders, channels, channel episodes and webinars by text.Read-onlySearch
Search across media, folders, subfolders, channels, channel episodes and webinars by text. Returns data grouped by resource type (folders, medias, channels and so on), each result with its hashed_id and name. Use this when you know words in a title or description. Use wistia_medias_list to filter media by folder, type or tags.
Inputs
qstringrequired- Search text. Example: onboarding
created_afterstring- Only results created on or after this UTC time (ISO 8601, ending in Z). Example: 2026-01-01T00:00:00Z
created_beforestring- Only results created on or before this UTC time (ISO 8601, ending in Z). Example: 2026-11-15T00:00:00Z
resource_typearray- Limit results to these types: media, folder, subfolder, channel, channel_episode, webinar. Example: ["media"]
tagsarray- Only results with any of these tag names. Example: ["webinar"]
wistia_subfolders_listList the subfolders of a folder.Read-onlyList Subfolders
List the subfolders of a folder. Returns subfolders with hashed_id, name, description and media_count. Use this to find a subfolder_id for wistia_medias_move.
Inputs
folderIdstringrequired- Hashed ID of the parent folder. Example: 4d23503f70
pageinteger- Page number to return, starting at 1. Example: 1
per_pageinteger- Items per page (Wistia's default is 10, maximum 100). Example: 25
sort_bystring- Sort field: name, created, updated, position or id. Example: positionone of
namecreatedupdatedpositionid sort_directioninteger- Sort direction: 1 for ascending (default), 0 for descending. Example: 0one of
01
wistia_folder_createCreate a folder for organizing media.WriteCreate Folder
Create a folder for organizing media. Returns the folder with hashed_id and name. Use this before importing or moving media into a new folder.
Inputs
namestringrequired- Folder name. Example: Product Launch 2026
adminEmailstring- Email of the folder's owner. Defaults to the account owner. Example: owner@example.com
anonymousCanDownloadboolean- If true, anyone with access can download media. Example: false
anonymousCanUploadboolean- If true, anyone with the link can upload to the folder. Example: false
descriptionstring- Folder description. Example: Launch videos and trailers
publicboolean- If true, the folder is publicly accessible. Example: false
wistia_folder_updateRename a folder or change its description and sharing settings.WriteUpdate Folder
Rename a folder or change its description and sharing settings. Returns the updated folder. Use wistia_folder_get to read the current settings first.
- Idempotent
Inputs
idstringrequired- Hashed ID of the folder (previously called project). Get it from wistia_folders_list. Example: 4d23503f70
anonymousCanDownloadboolean- Whether anyone with access can download. Example: false
anonymousCanUploadboolean- Whether anyone with the link can upload. Example: false
descriptionstring- New description. Example: Final launch assets
namestring- New name. Example: Product Launch 2026 (final)
publicboolean- Whether the folder is publicly accessible. Example: false
wistia_media_captions_createAdd captions to a media from SRT text, in one language.WriteAdd Media Captions
Add captions to a media from SRT text, in one language. Returns a success status with no body. Use this when no captions exist yet for the language. Use wistia_media_captions_delete first to replace existing ones.
Inputs
caption_filestringrequired- Contents of an SRT caption file, as text. Example: 1\n00:00:00,000 --> 00:00:02,500\nWelcome to the demo.\n
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
languagestring- ISO 639-2 language code of the captions. Defaults to English. Example: eng
wistia_media_copyCopy a media and its assets, optionally into another folder or to another owner.WriteCopy Media
Copy a media and its assets, optionally into another folder or to another owner. Returns the new media. Use this to duplicate a video. Use wistia_medias_move to move media instead.
Inputs
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
folder_idinteger- Numeric ID of the destination folder. Defaults to the source media's folder. Example: 1234567
ownerstring- Email of the user who will own the copy. Defaults to the source media's owner. Example: editor@example.com
wistia_media_import_urlImport a media file into Wistia from a public URL.WriteImport Media from URL
Import a media file into Wistia from a public URL. Returns a message and a background_job_status (id, status). The work runs asynchronously; follow it with wistia_background_job_status_get. Use this to add a video without a file upload. Find the new media with wistia_medias_list once the job finishes.
Inputs
urlstringrequired- Publicly accessible URL of the media file to import. Example: https://example.com/videos/launch.mp4
folder_idstring- Hashed ID of the folder to import into. A new folder is created if empty. Example: 4d23503f70
wistia_media_updateUpdate a media's name, description, tags, thumbnail or custom metadata.WriteUpdate Media
Update a media's name, description, tags, thumbnail or custom metadata. Returns the updated media. Use this to rename or retag one media. Use wistia_media_tags_add to add tags to many media.
- Idempotent
Inputs
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
custom_metadataobject- Custom metadata field values keyed by field key. Example: {"campaign": "spring-launch"}
descriptionstring- New description, plain text or markdown. Example: A 3-minute tour of the dashboard.
namestring- New media name. Example: Product Demo (2026)
new_still_media_idstring- Hashed ID of an image media to use as the new thumbnail (the still shown before play). Example: img456abc7
tagsarray- Tag names for the media; replaces all existing tags. Use wistia_media_tags_add to add without replacing. Example: ["demo", "product"]
wistia_medias_archiveArchive up to 100 media, hiding them from the library without deleting them.WriteArchive Media
Archive up to 100 media, hiding them from the library without deleting them. Returns a message and a background_job_status (id, status). The work runs asynchronously; follow it with wistia_background_job_status_get. Use wistia_medias_restore to bring them back. Use wistia_media_delete to delete one.
- Idempotent
Inputs
hashed_idsarrayrequired- Hashed IDs of the media to archive, up to 100 per request. Example: ["abc123def4", "xyz789ghi0"]
wistia_medias_moveMove up to 100 media to a folder and optional subfolder.WriteMove Media
Move up to 100 media to a folder and optional subfolder. Returns a message and a background_job_status (id, status). The work runs asynchronously; follow it with wistia_background_job_status_get. Use this to reorganize media. Use wistia_media_copy to duplicate instead.
- Idempotent
Inputs
folder_idstringrequired- Hashed ID of the destination folder. Example: 4d23503f70
hashed_idsarrayrequired- Hashed IDs of the media to move, up to 100 per request. Example: ["abc123def4", "xyz789ghi0"]
subfolder_idstring- Hashed ID of a subfolder of that folder; defaults to the folder's default subfolder. Example: sf8a7b6c5d
wistia_medias_restoreRestore up to 100 archived media into a folder.WriteRestore Archived Media
Restore up to 100 archived media into a folder. Returns a message and a background_job_status (id, status). The work runs asynchronously; follow it with wistia_background_job_status_get. Use this to undo wistia_medias_archive.
- Idempotent
Inputs
folder_idstringrequired- Hashed ID of the folder to restore the media to. Example: 4d23503f70
hashed_idsarrayrequired- Hashed IDs of the media to restore, up to 100 per request. Example: ["abc123def4", "xyz789ghi0"]
wistia_subfolder_createCreate a subfolder inside a folder.WriteCreate Subfolder
Create a subfolder inside a folder. Returns the subfolder with hashed_id and name. Use this to group media within a folder.
Inputs
folderIdstringrequired- Hashed ID of the parent folder. Example: 4d23503f70
namestringrequired- Subfolder name, up to 255 characters. Example: Trailers
descriptionstring- Description, up to 1000 characters. Example: Short trailers for social
wistia_tag_createCreate a tag.WriteCreate Tag
Create a tag. Returns the tag. Use wistia_media_tags_add to tag media; tags are also created on the fly there.
Inputs
namestringrequired- Tag name, up to 50 characters; stored lowercased and must not already exist. Example: webinar
wistia_folder_deleteDelete a folder and all the media inside it.DestructiveDelete Folder
Delete a folder and all the media inside it. Returns the deleted folder. Move media out first with wistia_medias_move if you want to keep them.
- Idempotent
Inputs
idstringrequired- Hashed ID of the folder (previously called project). Get it from wistia_folders_list. Example: 4d23503f70
wistia_media_captions_deleteRemove a media's captions in one language.DestructiveDelete Media Captions
Remove a media's captions in one language. Returns a success status with no body. Use this before adding replacement captions.
- Idempotent
Inputs
languageCodestringrequired- ISO 639-2 language code of the captions to remove. Example: eng
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
wistia_media_deleteDelete a media.DestructiveDelete Media
Delete a media. It moves to the account's Recently Deleted area, where it can be restored for a limited time. Returns the deleted media. Use wistia_medias_archive instead to hide media without deleting it.
- Idempotent
Inputs
mediaHashedIdstringrequired- Hashed ID of the media, the short code in its URL (for example the abc123def4 in wistia.com/medias/abc123def4). Get it from wistia_medias_list. Example: abc123def4
No tools match.