> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Wistia

> Wistia is a video marketing platform for hosting and managing media, channels, webinars, audience analytics, and account content.

![Wistia logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/wistia.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=221020393ef6a4f32e94e11665ffd903)

* **Category:** video & audio
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `WISTIA`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Folder
>
> **Slug:** `WISTIA_CREATE_FOLDER`
>
> Create a Wistia folder for organizing media, optionally make it public, and optionally set the specified email as its owner.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the new folder.
>
> **is\_public** `boolean`
>
> Whether the folder is publicly accessible.
>
> **admin\_email** `string`
>
> Email address of the person to set as the folder owner. Defaults to the Wistia Account Owner.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Folder
>
> **Slug:** `WISTIA_DELETE_FOLDER`
>
> Delete a Wistia folder by hashed ID, including the media inside it. This is destructive, but deleted content may remain recoverable for a limited account-dependent window before permanent purge.
>
> #### Input Parameters
>
> **folder\_hashed\_id** `string` *required*
>
> Hashed ID of the folder to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Media
>
> **Slug:** `WISTIA_DELETE_MEDIA`
>
> Delete one Wistia media item by hashed ID. This is destructive, but Wistia keeps deleted media recoverable for a limited account-dependent window before permanent purge.
>
> #### Input Parameters
>
> **media\_hashed\_id** `string` *required*
>
> Hashed ID of the media item to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Analytics Summary
>
> **Slug:** `WISTIA_GET_ANALYTICS_SUMMARY`
>
> Return account-wide or single-media Wistia performance metrics for an inclusive start date and exclusive end date.
>
> #### Input Parameters
>
> **end\_date** `string` *required*
>
> Exclusive analytics end date in YYYY-MM-DD format; must be after start\_date.
>
> **start\_date** `string` *required*
>
> Inclusive analytics start date in YYYY-MM-DD format.
>
> **media\_hashed\_id** `string`
>
> Optional media hashed ID. Omit for account-wide metrics.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Media
>
> **Slug:** `WISTIA_GET_MEDIA`
>
> Return detailed metadata, assets, folder placement, tags, and processing state for one Wistia media item.
>
> #### Input Parameters
>
> **media\_hashed\_id** `string` *required*
>
> Hashed ID of the media item.
>
> **description\_format** `string`
>
> Return the media description as markdown.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Media Customizations
>
> **Slug:** `WISTIA_GET_MEDIA_CUSTOMIZATIONS`
>
> Return explicitly saved Wistia player customization and plugin settings for one media item.
>
> #### Input Parameters
>
> **media\_hashed\_id** `string` *required*
>
> Hashed ID of the media item whose saved player settings to return.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Media Stats
>
> **Slug:** `WISTIA_GET_MEDIA_STATS`
>
> Return undated lifetime viewing statistics for one Wistia media item.
>
> #### Input Parameters
>
> **media\_id** `string` *required*
>
> Hashed or numeric ID of the media item.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Import Media from URL
>
> **Slug:** `WISTIA_IMPORT_MEDIA_FROM_URL`
>
> Start importing a publicly reachable media URL into Wistia, optionally into a folder. The response may be queued; call WISTIA\_GET\_MEDIA until its status is ready before using the media.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Publicly reachable URL of the media file to import.
>
> **name** `string`
>
> Optional display name for the imported media.
>
> **description** `string`
>
> Optional media description.
>
> **low\_priority** `boolean`
>
> Queue the import at lower processing priority.
>
> **folder\_hashed\_id** `string`
>
> Optional hashed ID of the destination folder.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Media
>
> **Slug:** `WISTIA_LIST_MEDIA`
>
> Return one page of media in the connected Wistia account with optional inventory filters and sorting.
>
> #### Input Parameters
>
> **name** `string`
>
> Exact media name to match.
>
> **page** `integer`
>
> One-based page number to return.
>
> **tags** `array`
>
> Tag names that every returned media item must match.
>
> **include** `string`
>
> Include active transcript speaker assignments in each media item.
>
> **sort\_by** `string ("id" | "name" | "created" | "updated" | "position")`
>
> Field used to order results. Cursor pagination requires id or created; page pagination also supports name, updated, and position.
>
> **archived** `boolean`
>
> Filter to archived media when true or active media when false.
>
> **per\_page** `integer`
>
> Maximum number of media items to return, up to 100.
>
> **folder\_id** `string`
>
> Hashed ID of the folder whose media items to return.
>
> **hashed\_ids** `array`
>
> Hashed media IDs to fetch as a batch.
>
> **media\_type** `string ("Video" | "Audio" | "Image" | "PdfDocument" | "MicrosoftOfficeDocument" | "Swf" | "UnknownType")`
>
> Wistia media type to return.
>
> **cursor\_after** `string`
>
> Return the media page immediately after this cursor.
>
> **cursor\_before** `string`
>
> Return the media page immediately before this cursor.
>
> **cursor\_enabled** `integer ("0" | "1")`
>
> Set to 1 to enable stable cursor pagination or 0 to disable it; do not combine with page.
>
> **sort\_direction** `integer ("0" | "1")`
>
> Sort direction: 0 for descending or 1 for ascending.
>
> **description\_format** `string`
>
> Return media descriptions in markdown format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Media Captions
>
> **Slug:** `WISTIA_LIST_MEDIA_CAPTIONS`
>
> Return caption and transcript tracks attached to one Wistia media item.
>
> #### Input Parameters
>
> **media\_hashed\_id** `string` *required*
>
> Hashed ID of the media item whose caption tracks to return.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Media Engagement Events
>
> **Slug:** `WISTIA_LIST_MEDIA_ENGAGEMENT_EVENTS`
>
> Return one page of individual viewing events retained from the last two years, optionally filtered by Wistia media item, visitor, or date range.
>
> #### Input Parameters
>
> **page** `integer`
>
> One-based page number to return.
>
> **end\_date** `string`
>
> End date in YYYY-MM-DD format.
>
> **media\_id** `string`
>
> Optional identifier of the media item whose events to return.
>
> **per\_page** `integer`
>
> Maximum number of events to return, up to 100.
>
> **start\_date** `string`
>
> Start date in YYYY-MM-DD format.
>
> **visitor\_key** `string`
>
> Optional identifier of the visitor whose events to return.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Content
>
> **Slug:** `WISTIA_SEARCH_CONTENT`
>
> Search the connected Wistia account for media, folders, subfolders, channels, and channel episodes by text and optional filters.
>
> #### Input Parameters
>
> **tags** `array`
>
> Optional tag names; results matching any supplied tag are returned.
>
> **query** `string` *required*
>
> Text to search for in Wistia content.
>
> **created\_after** `string`
>
> Only return resources created at or after this UTC ISO 8601 timestamp.
>
> **created\_before** `string`
>
> Only return resources created at or before this UTC ISO 8601 timestamp.
>
> **resource\_types** `array`
>
> Optional resource types: media, folder, subfolder, channel, or channel\_episode.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Media Archived State
>
> **Slug:** `WISTIA_SET_MEDIA_ARCHIVED_STATE`
>
> Archive one or more media items, or restore archived media into a destination folder, and wait for Wistia's background job to finish. Requires the connected account to have access to Wistia's Archiving feature.
>
> #### Input Parameters
>
> **archived** `boolean` *required*
>
> True to archive the media; false to restore it.
>
> **folder\_hashed\_id** `string`
>
> Destination folder hashed ID. Required only when restoring media.
>
> **media\_hashed\_ids** `array` *required*
>
> One to 100 media hashed IDs to archive or restore.
>
> **wait\_timeout\_seconds** `integer`
>
> Maximum seconds to wait for the background job to finish (1-600).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Folder
>
> **Slug:** `WISTIA_UPDATE_FOLDER`
>
> Update a Wistia folder's name, description, public visibility, or anonymous transfer settings.
>
> #### Input Parameters
>
> **name** `string`
>
> New folder name.
>
> **is\_public** `boolean`
>
> Whether the folder is publicly accessible.
>
> **description** `string`
>
> New folder description.
>
> **folder\_hashed\_id** `string` *required*
>
> Hashed ID of the folder to update.
>
> **anonymous\_can\_upload** `boolean`
>
> Whether anonymous visitors may upload to the folder.
>
> **anonymous\_can\_download** `boolean`
>
> Whether anonymous visitors may download from the folder.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Media
>
> **Slug:** `WISTIA_UPDATE_MEDIA`
>
> Update a Wistia media item's name, description, tags, or still image reference. Wistia returns descriptions as normalized HTML.
>
> #### Input Parameters
>
> **name** `string`
>
> New media name.
>
> **tags** `array`
>
> Complete tag-name list to apply to the media. Use an empty list to remove all tags.
>
> **description** `string`
>
> New media description. Wistia may normalize this content to HTML in the response.
>
> **media\_hashed\_id** `string` *required*
>
> Hashed ID of the media item to update.
>
> **new\_still\_media\_id** `string`
>
> Optional media ID to use as the new still image.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Media Customizations
>
> **Slug:** `WISTIA_UPDATE_MEDIA_CUSTOMIZATIONS`
>
> Partially update explicitly saved Wistia player customization settings for one media item. Null values remove saved keys.
>
> #### Input Parameters
>
> **customizations** `object` *required*
>
> Player settings to change. Set a key to null to remove that saved setting; additional provider or plugin keys are accepted.
>
> **media\_hashed\_id** `string` *required*
>
> Hashed ID of the media item whose player settings to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
