Seasons

Create a season

Create a season. 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

numberintegerrequired

Positive season number.

titlestring

Optional public season title.

descriptionstring

Optional season description.

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}/seasons', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "number": 1,
    "title": "Season one"
  }),
});

const data = await response.json();

Response201

{
  "id": "5c8e1b02-9d34-4f7a-b6e1-2a9c7d41f038"
}