New API endpoints: create, edit and publish episodes

What's new

• Create an episode: POST /api/v1/podcasts/:podcast_token/episodes creates a draft, starting from your podcast's episode defaults.
• Edit an episode: PATCH /api/v1/podcasts/:podcast_token/episodes/:episode_token changes the title, subtitle, slug, show notes, season, episode type or explicit flag. Only the fields you send change.
• Upload files: POST /api/v1/podcasts/:podcast_token/uploads gives you a signed URL to upload an MP3, cover art or a transcript. Attach the uploaded file when you create or edit an episode. Each episode now includes an audio_status so you can tell when its audio is ready.
• Publish and unpublish: POST .../episodes/:episode_token/publish releases an episode now, on a schedule, or backdated. POST .../unpublish takes it back to a draft.
• Upload files: POST /api/v1/podcasts/:podcast_token/uploads gives you a signed URL to upload an MP3, cover art (JPG, PNG, GIF or WebP) or a plain-text transcript, checked against your plan's limits before you send anything.
• Attach media to an episode: pass the uploaded file as audio_file_url, cover_file_url or transcript_file_url when you create or edit an episode, so one call can create an episode with its audio and artwork. Audio finishes processing in the background, and each episode's audio_status tells you when it's ready to publish.

Permissions

The API follows the same rules as your dashboard. Owners, managers and producers can create and publish episodes, and only while the podcast is active.

Getting started

Create a Read/Write key under Account → API Keys, then see the API documentation for every endpoint and field.