Sign in
Podcast Bot

Ingest an uploaded audio file as the episode with this key: copy it into the podcast's storage and run the post-recording jobs

put/podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/upload

Path parameters

podcastKeystring required
episodeKeystring required

Request body

fileUrlstring required

Publicly readable URL of the uploaded audio file. Fetched once, then not used again.

titlestring

Episode title. The file name is used when omitted.

descriptionstring
authorstring
originalFilenamestring

File name as uploaded, kept alongside the stored file.

durationinteger

Audio length in seconds. Optional: worked out from the file once it is uploaded when omitted.

fileSizeinteger

File size in bytes. Optional: measured from the uploaded file when omitted.

publishDatestring date-time

Publish date. Now when omitted.

explicitboolean

Response

Upload accepted; the file is fetched and processed afterwards

episodeKeystring

The episode key, whether supplied by the caller or generated.

statusstring

Episode status at the time of the response: PROCESSING while the file is being fetched.

alreadyExistedboolean

True when this key already existed and nothing new was started.

Changes

Changed in 1 of the 8 revisions of this API.1