API Documentation > Retrieve Episode


Retrieves details for an episode that has previously been created. Provide an Episode ID and Knit will return the corresponding episode information.

 

ARGUMENTS
episode
Required
The numeric identifier of the episode to be retrieved.

Returns

Returns a JSON object containing episode data if a valid episode id was provided, and returns and error otherwise.

 

Status polling

We’d prefer it if you used webhooks for this purpose. But, If you must use this method to determine if an episode is ready to be distributed, please be respectful of the service and limit calls to one per 30 second period. More than this and your API Key may be disabled. You’ll be looking for status to be “active” and the publish_status to be “live”. If either of those values are anything else it should not be distributed yet.

Definition:

Example Request:

Example Response