Skip to content

Add a new episode

POST
/episodes

Request Body required

Episode object that needs to be added

object
user_id
required

ID of the user creating the episode

integer format: int64
updated_by
required

ID of the user updating the episode

integer format: int64
title
required

Title of the episode

string
slug
required

URL-friendly slug of the episode

string
podcast_id
required

ID of the podcast the episode belongs to

integer format: int64
audio_file
required

Audio file for the episode

string format: binary
cover

Cover image for the episode

string format: binary
description

Description of the episode

string
location_name

Location associated with the episode

string
parental_advisory

Parental advisory rating

string
Allowed values: clean explicit
episode_number

Episode number (for serial podcasts)

integer format: int32
season_number

Season number (for serial podcasts)

integer format: int32
type

Type of episode

string
Allowed values: full trailer bonus
block

Block episode from being published

string
Allowed values: yes no
custom_rss

Custom RSS content

string
premium

Mark episode as premium content

string
Allowed values: yes no
transcript-choice

Transcript source choice

string
Allowed values: upload-file remote-url
transcript_file

Transcript file

string format: binary
transcript_remote_url

Remote URL for transcript

string format: uri
chapters-choice

Chapters source choice

string
Allowed values: upload-file remote-url
chapters_file

Chapters file

string format: binary
chapters_remote_url

Remote URL for chapters

string format: uri

Responses

201

Episode created successfully

object
id
required
integer format: int64
title
required
string
slug
required
string
podcast_id
required
integer format: int64
description_markdown
string
description_html
string
audio_url
string format: uri
cover_url
string format: uri
duration
integer format: int32
published_at
string format: date-time
created_by
required
integer format: int64
updated_by
required
integer format: int64

default

Unexpected error

object
status
integer format: int32
error
integer format: int32
messages
object
error
string