API Documentation > Add Episode


Adds a new episode. Upload audio files directly, or input remote assets, along with various metadata and Knit will return an episode identifier and start the encoding process. You can supply a webhook URL which we will fire upon completion of transcoding and audio leveling, or you can poll the status via the Retrieve Episode methodWebhooks are highly recommended over status polling.

 

ARGUMENTS
show_id
Required
A valid show_id integer. Can be retrieved from List all Shows method
title
Required
The episode title.
description
Required
The episode description.
urls
optional, if files Provided
One or more URLs for remotely hosted MP3 files
files
optional, if urls Provided
One or more MP3 files uploaded as multipart/form-data
status
Optional, default is published
Acceptable values: published or draft
tags
Optional, default tags will be used
Comma separated strings. List any keywords that pertain to the episode.
webhook
Optional
Webhook endpoint HTTP URL

Returns

Returns JSON Object containing episode metadata if request was successful, and returns an error otherwise.

Definition:

Example Request (remotely hosted files):

Example Request (directly uploaded files):

Example Success Response

Example Error Response

Example Webhook Success Response

 

Example Webhook Error Response