Upload or Import Media

post

https://example.com/

Endpoint to upload media files from a local system or import from a web URL.

Use multipart/form-data with a file parameter to upload from local system
Use application/x-www-form-urlencoded with a url parameter to import from web URL

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Uploading into a subfolder
The project_id parameter targets a top-level folder in Wistia. To land your media inside a subfolder, do this in two steps:

Upload to the parent folder by passing its hashed ID as project_id here.

Move the uploaded media into the subfolder with PUT /medias/move, passing folder_id (the parent folder), subfolder_id (the destination subfolder), and hashed_ids (the media you just uploaded).

The Upload endpoint itself does not accept a subfolder_id.

Form Data

project_id

string

The hashed id of the project to upload media into.

name

string

length ≤ 255

A display name to use for the media in Wistia.

description

string

A description to use for the media in Wistia.

contact_id

integer

A Wistia contact id.

access_token

string

deprecated

A 64 character hex string. This parameter can be found on your API access page OR can be the token you received from authenticating via Oauth2. Note this approach is legacy and discouraged. We recommend using Bearer Token authentication.

url

uri

required

The publicly accessible web location of the media file to import.

low_priority

boolean

Inform the encoding service that this upload can be considered lower priority than others. This is especially useful for platform customers doing bulk uploads or migrations. Setting this to "false" has no effect.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/x-www-form-urlencoded

Generated from available request content types

Allowed:

Responses

Uploading into a subfolder

200Successfully uploaded or imported.

400Error due to reaching the video limit of your account or other issues.

401Authorization error. Check your access_token.