Docs/Models

Media

object

A tracked media upload.

A Media record tracks a single upload through its lifecycle. Poll it until status is READY, then attach its id to a feed or item (as image_id, audio_default_id, audio_paid_id, video_default_id or video_paid_id), or to a social post (as upload_id).

Fields

idstringrequired

Unique upload identifier; use it to attach the media.

kindMediaKindrequired

The kind of media.

statusMediaStatusrequired

The processing state.

preview_urlstringoptional

URL to preview the processed media, when ready.

metadataAudioMetadataoptional

ID3 tags read from ITEM_AUDIO uploads, once READY; absent for other types or untagged files.

errorstringoptional

Failure reason, when status is ERROR.

Example
{
  "id": "6f1a2b3c-4d5e-6f70-8901-23456789abcd",
  "kind": "ITEM_AUDIO",
  "status": "READY",
  "preview_url": "https://media.fountain.fm/episodes/e5f6g7h8/audio.mp3"
}