> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Wistia

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.

**Authentication:** Bearer Token
**Categories:** Media, Marketing
**Tools:** 30: 15 read, 12 write, 3 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=WISTIA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "wistia"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="wistia_account_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Wistia credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'wistia_account_get',
  toolInput: {},
  connector: 'wistia',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="wistia_account_get",
    tool_input={},
    connection_name="wistia",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `wistia_account_get`

Get Account · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `wistia_account_stats_get`

Get Account Stats · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `wistia_background_job_status_get`

Get Background Job Status · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `backgroundJobStatusId` (`string`, required): ID of the background job, from the background_job_status returned by import, move, archive, restore or tag tools. Example: 98765432

Example input: `{"backgroundJobStatusId":"<backgroundJobStatusId>"}`

### `wistia_channels_list`

List Channels · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `per_page` (`integer`, optional): Items per page (Wistia's default is 10, maximum 100). Example: 25
- `sort_by` (`string`, optional): Sort field: created, id, updated or name. Example: updated. One of: `created`, `id`, `updated`, `name`.
- `sort_direction` (`integer`, optional): Sort direction: 1 for ascending (default), 0 for descending. Example: 0. One of: `0`, `1`.

Example input: `{}`

### `wistia_folder_get`

Get Folder · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Hashed ID of the folder (previously called project). Get it from wistia_folders_list. Example: 4d23503f70

Example input: `{"id":"<id>"}`

### `wistia_folders_list`

List Folders · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `hashed_ids` (`array`, optional): Only these folders. Example: ["4d23503f70"]
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `per_page` (`integer`, optional): Items per page (Wistia's default is 10, maximum 100). Example: 25
- `sort_by` (`string`, optional): Sort field: name, created, updated, mediaCount or id. Example: updated. One of: `name`, `created`, `updated`, `mediaCount`, `id`.
- `sort_direction` (`integer`, optional): Sort direction: 1 for ascending (default), 0 for descending. Example: 0. One of: `0`, `1`.

Example input: `{}`

### `wistia_media_captions_get`

Get Media Captions · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `languageCode` (`string`, required): Three-letter ISO 639-2 language code, for example eng, fre or spa. Example: eng
- `mediaHashedId` (`string`, required): 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
- `include` (`string`, optional): segments for time-coded cues, or diarized_segments for speaker-turn segments. Example: segments. One of: `segments`, `diarized_segments`.

Example input: `{"languageCode":"<languageCode>","mediaHashedId":"<mediaHashedId>"}`

### `wistia_media_captions_list`

List Media Captions · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mediaHashedId` (`string`, required): 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

Example input: `{"mediaHashedId":"<mediaHashedId>"}`

### `wistia_media_engagement_get`

Get Media Engagement · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mediaId` (`string`, required): Hashed ID (or numeric ID) of the video. Example: abc123def4

Example input: `{"mediaId":"<mediaId>"}`

### `wistia_media_get`

Get Media · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mediaHashedId` (`string`, required): 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
- `include` (`string`, optional): Set to speakers to include transcript speaker assignments. Example: speakers. One of: `speakers`.

Example input: `{"mediaHashedId":"<mediaHashedId>"}`

### `wistia_media_stats_get`

Get Media Stats · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mediaId` (`string`, required): Hashed ID (or numeric ID) of the video. Example: abc123def4

Example input: `{"mediaId":"<mediaId>"}`

### `wistia_medias_list`

List Media · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `archived` (`boolean`, optional): true for only archived media, false for only active media. Example: false
- `folder_id` (`string`, optional): Only media in this folder (hashed ID). Example: 4d23503f70
- `hashed_ids` (`array`, optional): Only these media (batch fetch by hashed ID). Example: ["abc123def4", "xyz789ghi0"]
- `name` (`string`, optional): Only media whose name exactly matches. Example: Product Demo
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `per_page` (`integer`, optional): Items per page (Wistia's default is 10, maximum 100). Example: 25
- `sort_by` (`string`, optional): Sort field: name, created, updated or position. Example: created. One of: `name`, `created`, `updated`, `position`.
- `sort_direction` (`integer`, optional): Sort direction: 1 for ascending (default), 0 for descending. Example: 0. One of: `0`, `1`.
- `tags` (`array`, optional): Only media that have all of these tag names. Example: ["webinar", "2026"]
- `type` (`string`, optional): Only this media type: Video, Audio, Image, PdfDocument, MicrosoftOfficeDocument, Swf or UnknownType. Example: Video. One of: `Video`, `Audio`, `Image`, `PdfDocument`, `MicrosoftOfficeDocument`, `Swf`, `UnknownType`.

Example input: `{}`

### `wistia_search`

Search · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): Search text. Example: onboarding
- `created_after` (`string`, optional): Only results created on or after this UTC time (ISO 8601, ending in Z). Example: 2026-01-01T00:00:00Z
- `created_before` (`string`, optional): Only results created on or before this UTC time (ISO 8601, ending in Z). Example: 2026-11-15T00:00:00Z
- `resource_type` (`array`, optional): Limit results to these types: media, folder, subfolder, channel, channel_episode, webinar. Example: ["media"]
- `tags` (`array`, optional): Only results with any of these tag names. Example: ["webinar"]

Example input: `{"q":"<q>"}`

### `wistia_subfolders_list`

List Subfolders · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folderId` (`string`, required): Hashed ID of the parent folder. Example: 4d23503f70
- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `per_page` (`integer`, optional): Items per page (Wistia's default is 10, maximum 100). Example: 25
- `sort_by` (`string`, optional): Sort field: name, created, updated, position or id. Example: position. One of: `name`, `created`, `updated`, `position`, `id`.
- `sort_direction` (`integer`, optional): Sort direction: 1 for ascending (default), 0 for descending. Example: 0. One of: `0`, `1`.

Example input: `{"folderId":"<folderId>"}`

### `wistia_tags_list`

List Tags · Read-only

List the tags in the account.
Returns tags with name, taggings_count, created_at and updated_at.
Use this to pick tags for filtering media.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number to return, starting at 1. Example: 1
- `per_page` (`integer`, optional): Items per page (Wistia's default is 10, maximum 100). Example: 25
- `sort_by` (`string`, optional): Sort field: name, created, updated, taggingsCount or id. Example: taggingsCount. One of: `name`, `created`, `updated`, `taggingsCount`, `id`.
- `sort_direction` (`integer`, optional): Sort direction: 1 for ascending (default), 0 for descending. Example: 0. One of: `0`, `1`.

Example input: `{}`

### `wistia_folder_create`

Create Folder · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Folder name. Example: Product Launch 2026
- `adminEmail` (`string`, optional): Email of the folder's owner. Defaults to the account owner. Example: owner@example.com
- `anonymousCanDownload` (`boolean`, optional): If true, anyone with access can download media. Example: false
- `anonymousCanUpload` (`boolean`, optional): If true, anyone with the link can upload to the folder. Example: false
- `description` (`string`, optional): Folder description. Example: Launch videos and trailers
- `public` (`boolean`, optional): If true, the folder is publicly accessible. Example: false

Example input: `{"name":"<name>"}`

### `wistia_folder_update`

Update Folder · Write

Rename a folder or change its description and sharing settings.
Returns the updated folder.
Use wistia_folder_get to read the current settings first.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Hashed ID of the folder (previously called project). Get it from wistia_folders_list. Example: 4d23503f70
- `anonymousCanDownload` (`boolean`, optional): Whether anyone with access can download. Example: false
- `anonymousCanUpload` (`boolean`, optional): Whether anyone with the link can upload. Example: false
- `description` (`string`, optional): New description. Example: Final launch assets
- `name` (`string`, optional): New name. Example: Product Launch 2026 (final)
- `public` (`boolean`, optional): Whether the folder is publicly accessible. Example: false

Example input: `{"id":"<id>"}`

### `wistia_media_captions_create`

Add Media Captions · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `caption_file` (`string`, required): Contents of an SRT caption file, as text. Example: 1\n00:00:00,000 --> 00:00:02,500\nWelcome to the demo.\n
- `mediaHashedId` (`string`, required): 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
- `language` (`string`, optional): ISO 639-2 language code of the captions. Defaults to English. Example: eng

Example input: `{"caption_file":"<caption_file>","mediaHashedId":"<mediaHashedId>"}`

### `wistia_media_copy`

Copy Media · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `mediaHashedId` (`string`, required): 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_id` (`integer`, optional): Numeric ID of the destination folder. Defaults to the source media's folder. Example: 1234567
- `owner` (`string`, optional): Email of the user who will own the copy. Defaults to the source media's owner. Example: editor@example.com

Example input: `{"mediaHashedId":"<mediaHashedId>"}`

### `wistia_media_import_url`

Import Media from URL · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): Publicly accessible URL of the media file to import. Example: https://example.com/videos/launch.mp4
- `folder_id` (`string`, optional): Hashed ID of the folder to import into. A new folder is created if empty. Example: 4d23503f70

Example input: `{"url":"<url>"}`

### `wistia_media_tags_add`

Tag Media · Write

Add tags to many media at once without removing their existing tags.
Returns a message and a background_job_status (id, status). The work runs asynchronously; follow it with wistia_background_job_status_get.
Use wistia_media_update to replace a single media's tags.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `hashed_ids` (`array`, required): Hashed IDs of the media to tag, up to many per request. Example: ["abc123def4", "xyz789ghi0"]
- `tag_names` (`array`, required): Tag names to add to each media. Example: ["webinar", "2026"]

Example input: `{"hashed_ids":["abc123def4","xyz789ghi0"],"tag_names":["webinar","2026"]}`

### `wistia_media_update`

Update Media · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `mediaHashedId` (`string`, required): 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_metadata` (`object`, optional): Custom metadata field values keyed by field key. Example: {"campaign": "spring-launch"}
- `description` (`string`, optional): New description, plain text or markdown. Example: A 3-minute tour of the dashboard.
- `name` (`string`, optional): New media name. Example: Product Demo (2026)
- `new_still_media_id` (`string`, optional): Hashed ID of an image media to use as the new thumbnail (the still shown before play). Example: img456abc7
- `tags` (`array`, optional): Tag names for the media; replaces all existing tags. Use wistia_media_tags_add to add without replacing. Example: ["demo", "product"]

Example input: `{"mediaHashedId":"<mediaHashedId>"}`

### `wistia_medias_archive`

Archive Media · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `hashed_ids` (`array`, required): Hashed IDs of the media to archive, up to 100 per request. Example: ["abc123def4", "xyz789ghi0"]

Example input: `{"hashed_ids":["abc123def4","xyz789ghi0"]}`

### `wistia_medias_move`

Move Media · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folder_id` (`string`, required): Hashed ID of the destination folder. Example: 4d23503f70
- `hashed_ids` (`array`, required): Hashed IDs of the media to move, up to 100 per request. Example: ["abc123def4", "xyz789ghi0"]
- `subfolder_id` (`string`, optional): Hashed ID of a subfolder of that folder; defaults to the folder's default subfolder. Example: sf8a7b6c5d

Example input: `{"folder_id":"<folder_id>","hashed_ids":["abc123def4","xyz789ghi0"]}`

### `wistia_medias_restore`

Restore Archived Media · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folder_id` (`string`, required): Hashed ID of the folder to restore the media to. Example: 4d23503f70
- `hashed_ids` (`array`, required): Hashed IDs of the media to restore, up to 100 per request. Example: ["abc123def4", "xyz789ghi0"]

Example input: `{"folder_id":"<folder_id>","hashed_ids":["abc123def4","xyz789ghi0"]}`

### `wistia_subfolder_create`

Create Subfolder · Write

Create a subfolder inside a folder.
Returns the subfolder with hashed_id and name.
Use this to group media within a folder.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `folderId` (`string`, required): Hashed ID of the parent folder. Example: 4d23503f70
- `name` (`string`, required): Subfolder name, up to 255 characters. Example: Trailers
- `description` (`string`, optional): Description, up to 1000 characters. Example: Short trailers for social

Example input: `{"folderId":"<folderId>","name":"<name>"}`

### `wistia_tag_create`

Create Tag · Write

Create a tag.
Returns the tag.
Use wistia_media_tags_add to tag media; tags are also created on the fly there.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Tag name, up to 50 characters; stored lowercased and must not already exist. Example: webinar

Example input: `{"name":"<name>"}`

### `wistia_folder_delete`

Delete Folder · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Hashed ID of the folder (previously called project). Get it from wistia_folders_list. Example: 4d23503f70

Example input: `{"id":"<id>"}`

### `wistia_media_captions_delete`

Delete Media Captions · Destructive

Remove a media's captions in one language.
Returns a success status with no body.
Use this before adding replacement captions.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `languageCode` (`string`, required): ISO 639-2 language code of the captions to remove. Example: eng
- `mediaHashedId` (`string`, required): 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

Example input: `{"languageCode":"<languageCode>","mediaHashedId":"<mediaHashedId>"}`

### `wistia_media_delete`

Delete Media · Destructive

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.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `mediaHashedId` (`string`, required): 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

Example input: `{"mediaHashedId":"<mediaHashedId>"}`

## Related

Other Media connectors ([all 65](/agentkit/connectors/?category=media)):

- [Spotify](/agentkit/connectors/spotify/): Scalekit connector, OAuth, 47 tools
- [Reddit](/agentkit/connectors/reddit/): Scalekit connector, OAuth, 105 tools
- [Diarize](/agentkit/connectors/diarize/): Scalekit connector, Access token, 3 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
