Publishing

Take a published episode back out of the feed.

Moves a published release back to ready and its RSS target to skipped, so the episode leaves the podcast feed on the next fetch; apps that read the feed drop it on their next refresh, and copies listeners already downloaded stay. The audio, the RSS GUID (the release id) and publishedAt are kept: publishing it again restores the same episode under its original date. Refused (409) for a release that is not published; refused (400) for a season-run release or one still live on a platform this cannot reach (YouTube, TikTok). An already-unpublished release is returned unchanged.

post/publishing-releases/{releaseId}/unpublish

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/publishing-releases/{releaseId}/unpublish
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Customer-generated stable identifier for safe retries of idempotent POST requests.

Request body

userConfirmedtrue required

Required: the user explicitly agreed to take this episode out of the public feed. A standing approval does not cover unpublishing.

Response

Publishing release envelope.

Changes

No recorded changes to this operation across all 2 revisions of this API.