Docs/Models

Item

object

An item in a feed you host.

An entry in a feed you host, the editable record behind a public Episode. Editing an item is how you edit the episode listeners see. The media fields are enclosure URLs. To publish, an item needs a title and default audio.

Fields

idstringrequired

Hosting ID, used everywhere in this API.

fountain_idstringoptional

Public Fountain Episode ID; absent until the item is published. Read-only.

titlestringoptional

Item title.

descriptionstringoptional

Item description, as Markdown.

season_numbernumberoptional

Season number.

item_numbernumberoptional

Item number within the season.

linksstring[]required

Associated links, each a URL. Max 3.

explicitbooleanrequired

Whether the item is marked explicit.

statusItemStatusrequired

The publishing state of the item.

imagestringoptional

Cover artwork URL.

audio_defaultstringoptional

Default (free) audio enclosure URL.

audio_paidstringoptional

Subscriber-only (paid) audio enclosure URL.

video_defaultstringoptional

Default (free) video enclosure URL (HLS playlist).

video_paidstringoptional

Subscriber-only (paid) video enclosure URL (HLS playlist).

bonusbooleanrequired

Whether the item is subscriber-only (a monetization variant flag).

adfreebooleanrequired

Whether a paid ad-free version is offered (regular items).

early_accessbooleanrequired

Whether a paid early-access version is offered (regular items).

early_access_daysnumberoptional

Early-access window length in days.

scheduledstringoptional

ISO-8601 scheduled release time. Read-only.

publishedstringoptional

ISO-8601 publish time. Read-only.

general_releasestringoptional

ISO-8601 general release (published + early_access_days). Read-only.

updatedstringrequired

ISO-8601 timestamp of the last update.

Example

{
  "id": "e5f6g7h8",
  "fountain_id": "episode:id:abc123",
  "title": "The Genesis Block",
  "description": "We dig into the **first block** ever mined.",
  "season_number": 2,
  "item_number": 14,
  "links": [
    "https://citadeldispatch.com/cd141"
  ],
  "explicit": false,
  "status": "PUBLISHED",
  "image": "https://media.fountain.fm/episodes/e5f6g7h8/cover.jpg",
  "audio_default": "https://media.fountain.fm/episodes/e5f6g7h8/audio.mp3",
  "bonus": false,
  "adfree": false,
  "early_access": false,
  "published": "2026-02-18T22:03:53.467Z",
  "updated": "2026-02-18T22:03:53.467Z"
}

Example

{
  "id": "e5f6g7h8",
  "fountain_id": "episode:id:abc123",
  "title": "The Genesis Block",
  "description": "We dig into the **first block** ever mined.",
  "season_number": 2,
  "item_number": 14,
  "links": [
    "https://citadeldispatch.com/cd141"
  ],
  "explicit": false,
  "status": "PUBLISHED",
  "image": "https://media.fountain.fm/episodes/e5f6g7h8/cover.jpg",
  "audio_default": "https://media.fountain.fm/episodes/e5f6g7h8/audio.mp3",
  "bonus": false,
  "adfree": false,
  "early_access": false,
  "published": "2026-02-18T22:03:53.467Z",
  "updated": "2026-02-18T22:03:53.467Z"
}

Fields

idstringrequired

Hosting ID, used everywhere in this API.

fountain_idstringoptional

Public Fountain Episode ID; absent until the item is published. Read-only.

titlestringoptional

Item title.

descriptionstringoptional

Item description, as Markdown.

season_numbernumberoptional

Season number.

item_numbernumberoptional

Item number within the season.

linksstring[]required

Associated links, each a URL. Max 3.

explicitbooleanrequired

Whether the item is marked explicit.

statusItemStatusrequired

The publishing state of the item.

imagestringoptional

Cover artwork URL.

audio_defaultstringoptional

Default (free) audio enclosure URL.

audio_paidstringoptional

Subscriber-only (paid) audio enclosure URL.

video_defaultstringoptional

Default (free) video enclosure URL (HLS playlist).

video_paidstringoptional

Subscriber-only (paid) video enclosure URL (HLS playlist).

bonusbooleanrequired

Whether the item is subscriber-only (a monetization variant flag).

adfreebooleanrequired

Whether a paid ad-free version is offered (regular items).

early_accessbooleanrequired

Whether a paid early-access version is offered (regular items).

early_access_daysnumberoptional

Early-access window length in days.

scheduledstringoptional

ISO-8601 scheduled release time. Read-only.

publishedstringoptional

ISO-8601 publish time. Read-only.

general_releasestringoptional

ISO-8601 general release (published + early_access_days). Read-only.

updatedstringrequired

ISO-8601 timestamp of the last update.

{ "id": "e5f6g7h8", "fountain_id": "episode:id:abc123", "title": "The Genesis Block", "description": "We dig into the **first block** ever mined.", "season_number": 2, "item_number": 14, "links": [ "https://citadeldispatch.com/cd141" ], "explicit": false, "status": "PUBLISHED", "image": "https://media.fountain.fm/episodes/e5f6g7h8/cover.jpg", "audio_default": "https://media.fountain.fm/episodes/e5f6g7h8/audio.mp3", "bonus": false, "adfree": false, "early_access": false, "published": "2026-02-18T22:03:53.467Z", "updated": "2026-02-18T22:03:53.467Z" }