Sign in
latestOpenAPI 3.0.02026-08-1610635191.3 KB

355890b6b4cc

Podcast

Add episode to podcast for automated distribution

Converts existing audio content into a podcast episode for automated platform distribution.

Automation Workflow:

  1. Generate audio content via content API → Get requestId
  2. Add episode via this endpoint → Links audio to podcast show
  3. RSS feed automatically updates with new episode
  4. Spotify, Apple Music, etc. automatically discover and publish new episode

Content Linking: Uses requestId to link existing audio content, enabling seamless conversion of any generated audio into podcast episodes without file uploads.

post/podcast/shows/{podcastId}/episodes

Path parameters

podcastIdstring required

The podcast show ID to add episode to

Request body

requestIdstring required

ID of existing audio content to convert into podcast episode

titlestring

Custom episode title (optional - defaults to original audio title)

descriptionstring

Custom episode description (optional - defaults to original audio title)

Example request

{
  "requestId": "req_789xyz123abc",
  "title": "Episode 1: The Future of AI",
  "description": "In this episode, we explore the exciting developments in artificial intelligence..."
}

Response

Episode added successfully - will appear on podcast platforms automatically

successboolean
episodeIdinteger

ID of the created episode

messagestring

Example response

{
  "success": true,
  "episodeId": 42,
  "message": "Episode added successfully"
}