1. Home
  2. Docs
  3. API Documentation
  4. API Requests
  5. Podcasts Management

Podcasts Management

List recorded podcasts

Channel Specific Resource

Since the recorded podcasts are channel specific (eg. each channel has its own recorded podcasts) you will need to specify the channel id (as returned at the Account & Server Information request.)

To get a list of the recorded podcasts for a channel make a GET request to the following URL:
https://hub.api.caster.fm/podcasts/{CHANNEL_ID}?token={PRIVATE_TOKEN}
If the request is successful an HTTP status code 200 will be returned along with the following JSON:

[
  {
    "id": "1e4f5a41-f563-44db-abfb-728138761446",
    "name": "Unnamed Broadcast",
    "recorded_at": "2020-06-11T17:32:48+03:00",
    "url": "//sapircast.caster.fm/podcast/1/27b44a7c-b2f5-4934-91a5-887f93073b70/1591885968.mp3"
  },
  {
    "id": "5c990517-7e4d-49ab-b028-9bcb08134542",
    "name": "Unnamed Broadcast",
    "recorded_at": "2020-05-23T18:57:24+03:00",
    "url": "//sapircast.caster.fm/podcast/1/27b44a7c-b2f5-4934-91a5-887f93073b70/1590249444.mp3"
  }
  ...
]

Update Podcast Name/Title

To update a podcast name/title make a POST request to the following URL:
https://hub.api.caster.fm/podcasts/{CHANNEL_ID}/{PODCAST_ID}/update?token={PRIVATE_TOKEN}
with the desired podcast name as a request parameter: ‘name’
The ‘name’ parameter present at the request, be an 250 characters.
If the request is successful an HTTP status code 200 will be returned along with the following JSON:

{
  "success": true,
  "error": null
}

Remove a podcast

To delete a podcast name/title make a POST request to the following URL:
https://hub.api.caster.fm/podcasts/{CHANNEL_ID}/{PODCAST_ID}/delete?token={PRIVATE_TOKEN}
If the request is successful an HTTP status code 200 will be returned along with the following JSON:

{
  "success": true,
  "error": null
}

Was this article helpful to you? Yes No