Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Wistia

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the Wistia connection

    In AgentKit > Connections, create a Wistia connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'wistia'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'wistia_account_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • wistia_account_getGet a summary of the Wistia account.Read-only

    Get 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-only

    Get 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-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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-only

    Get 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-only

    List 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