Update details of a single podcast episode.

PUT

https://demo.azuracast.com/api/station/{station_id}/podcast/{podcast_id}/episode/{id}

curl -X PUT 'https://demo.azuracast.com/api/station/0/podcast/string/episode/string' \
  -H 'X-API-Key: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "id": "string",
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "season_number": 0,
  "episode_number": 0,
  "created_at": 0,
  "publish_at": 0,
  "is_published": true,
  "has_media": true,
  "playlist_media_id": "string",
  "playlist_media": {
    "text": "Chet Porter - Aluko River",
    "artist": "Chet Porter",
    "title": "Aluko River",
    "album": "Moving Castle",
    "genre": "Rock",
    "isrc": "US28E1600021",
    "lyrics": "",
    "id": "9f33bbc912c19603e51be8e0987d076b",
    "art": "https://picsum.photos/1200/1200",
    "custom_fields": [
      "custom_field_value"
    ]
  },
  "media": {
    "id": "string",
    "original_name": "string",
    "length": 0,
    "length_text": "string",
    "path": "string",
    "size": 19693056
  },
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0
}'

const body = `{
  "id": "string",
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "season_number": 0,
  "episode_number": 0,
  "created_at": 0,
  "publish_at": 0,
  "is_published": true,
  "has_media": true,
  "playlist_media_id": "string",
  "playlist_media": {
    "text": "Chet Porter - Aluko River",
    "artist": "Chet Porter",
    "title": "Aluko River",
    "album": "Moving Castle",
    "genre": "Rock",
    "isrc": "US28E1600021",
    "lyrics": "",
    "id": "9f33bbc912c19603e51be8e0987d076b",
    "art": "https://picsum.photos/1200/1200",
    "custom_fields": [
      "custom_field_value"
    ]
  },
  "media": {
    "id": "string",
    "original_name": "string",
    "length": 0,
    "length_text": "string",
    "path": "string",
    "size": 19693056
  },
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0
}`;

const response = await fetch('https://demo.azuracast.com/api/station/0/podcast/string/episode/string', {
  method: 'PUT',
  headers: {
    'X-API-Key': 'YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "id": "string",
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "season_number": 0,
  "episode_number": 0,
  "created_at": 0,
  "publish_at": 0,
  "is_published": true,
  "has_media": true,
  "playlist_media_id": "string",
  "playlist_media": {
    "text": "Chet Porter - Aluko River",
    "artist": "Chet Porter",
    "title": "Aluko River",
    "album": "Moving Castle",
    "genre": "Rock",
    "isrc": "US28E1600021",
    "lyrics": "",
    "id": "9f33bbc912c19603e51be8e0987d076b",
    "art": "https://picsum.photos/1200/1200",
    "custom_fields": [
      "custom_field_value"
    ]
  },
  "media": {
    "id": "string",
    "original_name": "string",
    "length": 0,
    "length_text": "string",
    "path": "string",
    "size": 19693056
  },
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0
}'''

response = requests.put(
    'https://demo.azuracast.com/api/station/0/podcast/string/episode/string',
    data=body.encode('utf-8'),
    headers={
        'X-API-Key': 'YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "id": "string",
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "season_number": 0,
  "episode_number": 0,
  "created_at": 0,
  "publish_at": 0,
  "is_published": true,
  "has_media": true,
  "playlist_media_id": "string",
  "playlist_media": {
    "text": "Chet Porter - Aluko River",
    "artist": "Chet Porter",
    "title": "Aluko River",
    "album": "Moving Castle",
    "genre": "Rock",
    "isrc": "US28E1600021",
    "lyrics": "",
    "id": "9f33bbc912c19603e51be8e0987d076b",
    "art": "https://picsum.photos/1200/1200",
    "custom_fields": [
      "custom_field_value"
    ]
  },
  "media": {
    "id": "string",
    "original_name": "string",
    "length": 0,
    "length_text": "string",
    "path": "string",
    "size": 19693056
  },
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0
}

{
  "success": true,
  "message": "Changes saved successfully.",
  "formatted_message": "<b>Changes saved successfully.</b>"
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

Body

application/json

idstring

titlestring

linkstring | null

descriptionstring

description_shortstring

explicitboolean

season_numberinteger | null

episode_numberinteger | null

created_atinteger

publish_atinteger

is_publishedboolean

has_mediaboolean

playlist_media_idstring | null

playlist_mediaApi_HasSongFields & object | null

Show child attributes

One of

textstring

The song title, usually “Artist - Title”

Example

Chet Porter - Aluko River

artiststring | null

The song artist.

Example

Chet Porter

titlestring | null

The song title.

Example

Aluko River

albumstring | null

The song album.

Example

Moving Castle

genrestring | null

The song genre.

Example

Rock

isrcstring | null

The International Standard Recording Code (ISRC) of the file.

Example

US28E1600021

lyricsstring | null

Lyrics to the song.

Example

idstring

The song’s 32-character unique identifier hash

Example

9f33bbc912c19603e51be8e0987d076b

artstring

URL to the album artwork (if available).

Example

https://picsum.photos/1200/1200

custom_fieldsArray<string>

mediaApi_PodcastMedia | null

Show child attributes

One of

idstring | null

original_namestring | null

lengthnumber<float>

length_textstring | null

pathstring | null

sizeinteger

The file size (in bytes).

Example

19693056

has_custom_artboolean

artstring | null

art_updated_atinteger

Parameters

station_idinteger | stringrequiredpath

podcast_idstringrequiredpath

Podcast ID

idstringrequiredpath

Podcast Episode ID

Response

200OKApi_Status

Success

Response fields application/json

successbooleanrequired

Example

true

messagestringrequired

Example

Changes saved successfully.

formatted_messagestringrequired

Example

<b>Changes saved successfully.</b>

403ForbiddenApi_Error

Access denied.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

404Not FoundApi_Error

Record not found.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

500Internal Server ErrorApi_Error

A generic exception has occurred.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

Authorization

ApiKeyapiKey in header

Docs by Sourcey