Episodes

Create an episode

Create an episode. Returns JSON unless otherwise noted.

Authentication

Authorizationbearer token

Requires podcasts.write — Create and update podcasts, seasons, and episodes.

Path parameters

podcastIdstringrequired

The podcast identifier.

Body parameters

application/json

titlestringrequired

The public episode title.

typeFULL | TRAILER | BONUSrequired

The episode type exposed in the podcast feed.

descriptionstring

A plain-text or HTML episode description.

seasonIdstring

The season this episode belongs to.

episodeNumberinteger

Episode number within the season.

explicitboolean

Whether the episode contains explicit material.

Responses

201The resource was created

400The request is invalid

401Authentication is missing or invalid

403The token does not have the required scope

429Rate limit exceeded

const response = await fetch('https://api.ufw.dev/v1/podcasts/{podcastId}/episodes', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "title": "Building a publishing system",
    "type": "FULL",
    "episodeNumber": 1,
    "explicit": false
  }),
});

const data = await response.json();

Response201

{
  "id": "3a7d2c11-45e8-4b90-9f21-6c0b8ad3e577",
  "status": "DRAFT"
}