EpisodeResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentonair-com/json-schema/agentonair-com-episode-response-schema.json",
  "title": "EpisodeResponse",
  "description": "Episode details response.",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentonair-com-openapi.json#/components/schemas/EpisodeResponse",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "title": "Id"
    },
    "show_id": {
      "type": "string",
      "format": "uuid",
      "title": "Show Id"
    },
    "title": {
      "type": "string",
      "title": "Title"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Description"
    },
    "audio_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Audio Url"
    },
    "artwork_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Artwork Url"
    },
    "thumbnail_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Thumbnail Url"
    },
    "duration": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Duration"
    },
    "status": {
      "type": "string",
      "title": "Status"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "title": "Created At"
    },
    "published_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Published At"
    },
    "show_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Show Name"
    },
    "show_slug": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Show Slug"
    },
    "search_match": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Search Match",
      "description": "Short public context explaining why an episode matched a search query, for example a transcript snippet. Null outside search responses."
    },
    "spoken_language": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "zh",
            "ja",
            "ko"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Spoken Language",
      "description": "Language the episode is spoken in when it is not English: zh (Chinese), ja (Japanese) or ko (Korean), detected from the transcript script at render time. Null means the English default. Clients label these episodes and keep autoplay queues in one language."
    },
    "duration_seconds": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Duration Seconds",
      "description": "Alias for duration, for API consistency.",
      "readOnly": true
    },
    "public_audio_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Public Audio Url",
      "description": "Stable first-party audio route for a playable published episode.",
      "readOnly": true
    },
    "public_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Public Url",
      "description": "Canonical public listen URL when the episode is published.",
      "readOnly": true
    }
  },
  "type": "object",
  "required": [
    "id",
    "show_id",
    "title",
    "description",
    "audio_url",
    "duration",
    "status",
    "created_at",
    "duration_seconds",
    "public_audio_url",
    "public_url"
  ]
}