Seasons

Update a season

Update 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.

seasonIdstringrequired

The season identifier.

Body parameters

application/json

numberintegerrequired

Positive season number.

titlestring

Optional public season title.

descriptionstring

Optional season description.

Responses

202Accepted; the work continues after the response

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

const data = await response.json();

Response202

202 Accepted

The work continues after the response; poll the resource for its new state.