Jellypod API API

Programmatic access to Jellypod podcasts, episodes, hosts, sources, and voices.

GitHub OpenAPI

Operations 72

GET / API discovery index #
GET /health #
GET /v1/account Get the authenticated organization #
GET /v1/episodes/{episode_id}/analytics Get streaming analytics for an episode #
GET /v1/podcasts/{podcast_id}/analytics Get streaming analytics for a podcast #
GET /v1/episodes List episodes #
POST /v1/episodes Create an empty episode #
POST /v1/episodes/generate Generate a new episode (asynchronous) #
POST /v1/episodes/import Import a script as a new episode #
POST /v1/episodes/{episode_id}/export Export saved episode content #
PATCH /v1/episodes/{episode_id} Update episode fields #
GET /v1/episodes/{episode_id} Get an episode #
DELETE /v1/episodes/{episode_id} Delete an episode #
PUT /v1/episodes/{episode_id}/image Upload an episode cover image #
POST /v1/episodes/{episode_id}/publish Publish or schedule an episode #
POST /v1/episodes/{episode_id}/unpublish Unpublish a published or scheduled episode #
GET /v1/episodes/{episode_id}/timestamps Get episode timestamps #
GET /v1/episodes/{episode_id}/status Check episode generation #
POST /v1/episodes/{episode_id}/retry Retry a failed episode #
GET /v1/episodes/{episode_id}/download Get the episode download #
GET /v1/episodes/{episode_id}/video-settings Get episode captions and watermark #
PATCH /v1/episodes/{episode_id}/video-settings Update episode captions and watermark #
GET /v1/hosts List hosts #
POST /v1/hosts Create a host #
GET /v1/hosts/{host_id} Get a host #
PATCH /v1/hosts/{host_id} Update a host #
DELETE /v1/hosts/{host_id} Delete a host #
GET /v1/insights Get Insights across all content #
GET /v1/podcasts List podcasts #
POST /v1/podcasts Create a podcast #
GET /v1/podcasts/{podcast_id} Get a podcast #
PATCH /v1/podcasts/{podcast_id} Update a podcast #
DELETE /v1/podcasts/{podcast_id} Delete a podcast #
PUT /v1/podcasts/{podcast_id}/image Replace the podcast cover image #
GET /v1/sources List sources #
POST /v1/sources Create a source #
GET /v1/sources/{source_id} Get a source #
DELETE /v1/sources/{source_id} Delete a source #
POST /v1/sources/uploads Request a file upload #
POST /v1/sources/{source_id}/complete-upload Complete a file upload #
GET /v1/videos/options Discover video creation options #
GET /v1/shorts/options Discover short creation options #
GET /v1/voiceovers/options Discover voiceover creation options #
GET /v1/videos/{product_id} Get a video #
DELETE /v1/videos/{product_id} Delete a video #
GET /v1/videos/{product_id}/status Check video generation #
POST /v1/videos/{product_id}/retry Retry a failed video #
GET /v1/videos/{product_id}/download Get the video download #
GET /v1/videos/{product_id}/video-settings Get video captions and watermark #
PATCH /v1/videos/{product_id}/video-settings Update video captions and watermark #
GET /v1/shorts/{product_id} Get a short #
DELETE /v1/shorts/{product_id} Delete a short #
GET /v1/shorts/{product_id}/status Check short generation #
POST /v1/shorts/{product_id}/retry Retry a failed short #
GET /v1/shorts/{product_id}/download Get the short download #
GET /v1/shorts/{product_id}/video-settings Get short captions and watermark #
PATCH /v1/shorts/{product_id}/video-settings Update short captions and watermark #
GET /v1/voiceovers/{product_id} Get a voiceover #
DELETE /v1/voiceovers/{product_id} Delete a voiceover #
GET /v1/voiceovers/{product_id}/status Check voiceover generation #
POST /v1/voiceovers/{product_id}/retry Retry a failed voiceover #
GET /v1/voiceovers/{product_id}/download Get the voiceover download #
GET /v1/voiceovers/{product_id}/video-settings Get voiceover captions and watermark #
PATCH /v1/voiceovers/{product_id}/video-settings Update voiceover captions and watermark #
GET /v1/videos List videos #
POST /v1/videos Create a video #
GET /v1/shorts List shorts #
POST /v1/shorts Create a short #
GET /v1/voiceovers List voiceovers #
POST /v1/voiceovers Create a voiceover #
GET /v1/voices List voices #
GET /v1/voices/{voice_id} Get a voice #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/jellypod-com:jellypod-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jellypod-com-api-openapi.json Raw ↑
{"info":{"contact":{"email":"support@jellypod.com","name":"Jellypod Support","url":"https://docs.jellypod.com/api"},"description":"Programmatic access to Jellypod podcasts, episodes, hosts, sources, and voices.","license":{"name":"Proprietary"},"title":"Jellypod API","version":"1.0.0"},"openapi":"3.1.0","servers":[{"description":"Production","url":"https://api.jellypod.com"},{"description":"Local development","url":"http://localhost:3003"}],"tags":[{"description":"Service liveness checks.","name":"Health"},{"description":"Authenticated organization details.","name":"Account"},{"description":"Podcast resources.","name":"Podcasts"},{"description":"Episode resources.","name":"Episodes"},{"description":"Streaming and playback metrics for podcasts and episodes.","name":"Analytics"},{"description":"Host (speaker) resources.","name":"Hosts"},{"description":"Source documents fed to generation.","name":"Sources"},{"description":"Video generation resources.","name":"Videos"},{"description":"Short generation resources.","name":"Shorts"},{"description":"Voiceover generation resources.","name":"Voiceovers"},{"description":"TTS voices.","name":"Voices"}],"components":{"securitySchemes":{"bearerAuth":{"description":"API key issued from /settings/api-keys in the Jellypod studio. Send as `Authorization: Bearer <key>`.","scheme":"bearer","type":"http"}},"schemas":{"ApiIndex":{"type":"object","properties":{"authentication":{"type":"object","properties":{"documentation_url":{"type":"string","format":"uri"},"header":{"type":"string"},"keys_url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["bearer"]}},"required":["documentation_url","header","keys_url","type"]},"description":{"type":"string"},"developers_url":{"type":"string","format":"uri"},"documentation_url":{"type":"string","format":"uri"},"errors":{"type":"object","properties":{"format":{"type":"string","enum":["application/problem+json"]},"specification":{"type":"string","format":"uri"}},"required":["format","specification"]},"llms_txt_url":{"type":"string","format":"uri"},"mcp":{"type":"object","properties":{"documentation_url":{"type":"string","format":"uri"},"server_card_url":{"type":"string","format":"uri"},"transport":{"type":"string","enum":["streamable-http"]},"url":{"type":"string","format":"uri"}},"required":["documentation_url","server_card_url","transport","url"]},"name":{"type":"string"},"openapi_url":{"type":"string","format":"uri"},"version":{"type":"string"}},"required":["authentication","description","developers_url","documentation_url","errors","llms_txt_url","mcp","name","openapi_url","version"],"description":"Discovery document linking the OpenAPI spec, docs, authentication, and MCP server."},"Account":{"type":"object","properties":{"data":{"type":"object","properties":{"organization_id":{"type":"string","readOnly":true},"plan":{"type":"string","readOnly":true},"credits":{"type":"object","properties":{"balance":{"type":"number","readOnly":true}},"required":["balance"]}},"required":["organization_id","plan","credits"]}},"required":["data"],"description":"Caller organization, current plan, and credit balance."},"ApiError":{"type":"object","properties":{"detail":{"type":"string","description":"Longer human-readable explanation when available."},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]},"description":"Per-field validation failures. Present when `type` is `validation_error`."},"reason":{"type":"string","enum":["unresolved_speakers"],"description":"Script import failure when one or more Speakers have no saved Character match."},"recovery":{"type":"object","properties":{"action":{"type":"string","enum":["correct_input","choose_characters","check_account","poll_content","open_studio","check_content","reconnect","retry","check_result"]},"idempotency_key":{"type":"string","enum":["reuse","new"]},"poll_after_seconds":{"type":"number","minimum":0},"tool":{"type":"string","enum":["list_characters","list_content","get_content","save_podcast"]}},"required":["action"]},"request_id":{"type":"string","description":"Correlation id, also returned in the `X-Request-Id` response header. Include in support requests."},"speakers":{"type":"array","items":{"type":"string"},"description":"Speaker labels needing a saved Character match when reason is unresolved_speakers."},"status":{"type":"integer","description":"HTTP status code mirrored from the response."},"title":{"type":"string","description":"Short human-readable summary."},"type":{"type":"string","enum":["bad_request","validation_error","unauthorized","forbidden","not_found","conflict","method_not_allowed","unsupported_media_type","unprocessable_entity","rate_limited","bad_gateway","internal_error"],"description":"Machine-readable error class. Suitable for switch/match in client code."}},"required":["status","title","type"],"description":"RFC 9457 error envelope returned for all non-2xx responses from the Jellypod API."},"EpisodeAnalytics":{"type":"object","properties":{"downloads":{"$ref":"#/components/schemas/EpisodeDownloads"},"video_views":{"$ref":"#/components/schemas/EpisodeVideoViews"},"as_of":{"type":"string","description":"ISO-8601 time these metrics were computed.","readOnly":true},"complete":{"type":"boolean","description":"Whether every analytics source answered in full. When false an upstream (OP3 or Mux) was degraded, so the numbers are a floor rather than a total; retry later for a complete read.","readOnly":true},"episode_id":{"type":"string","format":"uuid","readOnly":true}},"required":["downloads","video_views","as_of","complete","episode_id"],"description":"Streaming metrics for a single episode. Audio download windows are measured since publish; video view windows are rolling."},"EpisodeDownloads":{"type":"object","properties":{"first_7_days":{"type":"number","minimum":0,"description":"Audio downloads in the first 7 days after publish."},"first_30_days":{"type":"number","minimum":0,"description":"Audio downloads in the first 30 days after publish."},"total":{"type":"number","minimum":0,"description":"All-time audio downloads (OP3)."}},"required":["first_7_days","first_30_days","total"]},"EpisodeVideoViews":{"type":"object","properties":{"last_7_days":{"type":"number","minimum":0,"description":"Web video views in the last 7 days."},"last_30_days":{"type":"number","minimum":0,"description":"Web video views in the last 30 days."},"total":{"type":"number","minimum":0,"description":"Web video views over the last 90 days (Mux retention window)."}},"required":["last_7_days","last_30_days","total"]},"PodcastAnalytics":{"type":"object","properties":{"analytics_enabled":{"type":"boolean","description":"Whether download tracking is enabled. When false, audio metrics are 0."},"as_of":{"type":"string","description":"ISO-8601 time these metrics were computed.","readOnly":true},"complete":{"type":"boolean","description":"Whether every analytics source answered in full. When false an upstream (OP3 or Mux) was degraded, so the numbers are a floor rather than a total; retry later for a complete read.","readOnly":true},"episodes":{"type":"array","items":{"type":"object","properties":{"downloads":{"type":"object","properties":{"first_7_days":{"type":"number","minimum":0,"description":"Audio downloads in the first 7 days after publish."},"first_30_days":{"type":"number","minimum":0,"description":"Audio downloads in the first 30 days after publish."},"total":{"type":"number","minimum":0,"description":"All-time audio downloads (OP3)."}},"required":["first_7_days","first_30_days","total"]},"video_views":{"type":"object","properties":{"last_7_days":{"type":"number","minimum":0,"description":"Web video views in the last 7 days."},"last_30_days":{"type":"number","minimum":0,"description":"Web video views in the last 30 days."},"total":{"type":"number","minimum":0,"description":"Web video views over the last 90 days (Mux retention window)."}},"required":["last_7_days","last_30_days","total"]},"episode_id":{"type":"string","format":"uuid","readOnly":true}},"required":["downloads","video_views","episode_id"]}},"plays_by_app":{"type":"object","additionalProperties":{"type":"number","minimum":0},"description":"Audio downloads grouped by client app (Spotify, Apple Podcasts, Overcast, ...). Show-level."},"podcast_id":{"type":"string","format":"uuid","readOnly":true},"totals":{"type":"object","properties":{"downloads":{"type":"number","minimum":0,"description":"All-time audio downloads (OP3)."},"last_7_days":{"type":"number","minimum":0,"description":"Combined plays in the last 7 days."},"last_30_days":{"type":"number","minimum":0,"description":"Combined plays in the last 30 days."},"plays":{"type":"number","minimum":0,"description":"All-time audio downloads + web video views."},"video_views":{"type":"number","minimum":0,"description":"Web video views (Mux, last 90 days)."}},"required":["downloads","last_7_days","last_30_days","plays","video_views"]}},"required":["analytics_enabled","as_of","complete","episodes","plays_by_app","podcast_id","totals"],"description":"Streaming metrics for a podcast: combined totals, per-app download breakdown, and per-episode metrics."},"ListEpisodesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Episode"}}},"required":["data"],"description":"Page of episodes. Use the `Link` response header (`rel=\"next\"`) to paginate."},"Episode":{"type":"object","properties":{"audio_url":{"type":["string","null"],"readOnly":true},"created_at":{"type":"string","readOnly":true},"description":{"type":["string","null"]},"generation":{"type":["object","null"],"properties":{"completed_at":{"type":["string","null"]},"error_message":{"type":"string"},"started_at":{"type":"string"},"state":{"type":"string","enum":["generating","completed","failed"]},"skipped_sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"url":{"type":["string","null"]},"reason":{"type":"string"}},"required":["id","title","url","reason"]}}},"required":["completed_at","started_at","state"],"readOnly":true},"host_ids":{"type":["array","null"],"items":{"type":"string"}},"id":{"type":"string","format":"uuid","readOnly":true},"image_url":{"type":["string","null"]},"podcast_id":{"type":"string","format":"uuid"},"published_at":{"type":["string","null"],"readOnly":true},"scheduled_at":{"type":["string","null"],"readOnly":true},"source_ids":{"type":"array","items":{"type":"string","format":"uuid"},"readOnly":true},"status":{"$ref":"#/components/schemas/EpisodeStatus"},"title":{"type":["string","null"]},"updated_at":{"type":"string","readOnly":true},"url":{"type":["string","null"],"readOnly":true},"video_url":{"type":["string","null"],"readOnly":true}},"required":["audio_url","created_at","description","generation","host_ids","id","image_url","podcast_id","published_at","scheduled_at","source_ids","status","title","updated_at","url","video_url"],"description":"A podcast episode with publishing metadata and (when available) audio/video URLs."},"EpisodeStatus":{"type":"string","enum":["draft","published","scheduled"],"description":"Lifecycle state stored on the episode row. Generation progress is reported separately on the `generation` field, `generating`/`completed`/`failed` are not `status` values.","readOnly":true},"CreateEpisodeInput":{"type":"object","properties":{"description":{"type":"string","maxLength":2000},"host_ids":{"type":"array","items":{"type":"string"}},"image":{"type":"string","format":"uri"},"podcast_id":{"type":"string","format":"uuid","description":"Podcast that will own the new episode."},"title":{"type":"string","minLength":1,"maxLength":255}},"required":["podcast_id"],"additionalProperties":false,"description":"Fields for creating an empty episode row. No content is generated."},"AcceptedEpisodeResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"created_at":{"type":"string"},"host_ids":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"podcast_id":{"type":"string"},"status":{"type":"string","enum":["generating"]},"updated_at":{"type":"string"},"workflow_run_id":{"type":"string"}},"required":["created_at","host_ids","id","podcast_id","status","updated_at","workflow_run_id"]}},"required":["data"],"description":"Acknowledgement for an asynchronously-generated episode."},"GenerateEpisodeInput":{"type":"object","properties":{"host_ids":{"type":"array","items":{"type":"string"},"description":"Hosts to use for generation. In script mode, every segment host_id must be included here, or omit host_ids to infer them from the script.","example":["2e6939fe","a91c4d22"]},"language":{"type":"string","enum":["en","es","fr","hi","pt","zh","de","ja","ar","ru","ko","id","it","nl","tr","pl","sv","fil","ms","ro","uk","el","cs","da","fi","no","bg","hr","sk","ta","ace","af","ak","sq","am","hy","as","awa","az","ban","bjn","ba","eu","be","bem","bn","bho","bs","bug","my","yue","ca","ckb","hne","ny","crh","dyu","dz","et","gl","lg","ka","gn","gu","ht","ha","he","hu","is","ig","ga","jv","kab","kam","kn","ks","kk","km","ki","rw","kg","ky","lo","ltg","lv","lt","lb","mk","mag","mai","ml","mt","mni","mr","min","lus","mn","ne","nso","or","pag","ps","fa","pa","sat","sr","sd","si","sl","so","sw","ss","tg","te","th","ti","ur","ug","uz","vi","cy"]},"options":{"type":"object","properties":{"episode_length":{"type":"string"},"episode_length_minutes":{"type":"integer","minimum":1,"maximum":75},"web_search":{"type":"boolean"}},"default":{},"description":"Prompt-mode generation options. These are not used when `script` is provided."},"prompt":{"type":"string","minLength":10,"maxLength":10000,"description":"Prompt used to write the episode script. Omit it to write the episode from `source_ids` alone. Provide `prompt`, `source_ids`, or both, or `script` instead.","example":"Create a friendly two-host episode about simple habits for a calmer workweek."},"script":{"$ref":"#/components/schemas/ImportedEpisodeScript"},"source_ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Source documents for prompt-based generation. Not supported when `script` is provided."},"podcast_id":{"type":"string","format":"uuid","description":"Podcast that will own the generated episode."},"outputs":{"type":"array","items":{"type":"string","enum":["audio","video"]},"maxItems":2,"description":"Files to produce: audio (MP3), video (MP4 with sound), both, or [] for an editable draft. Each requested file becomes downloadable independently. Do not combine with render. Omission preserves legacy render behavior."},"render":{"type":"boolean","description":"Deprecated: use outputs. True produces audio and video; false or omission leaves an editable draft. Do not combine with outputs.","deprecated":true}},"required":["podcast_id"],"additionalProperties":false,"description":"Fields for generating a new episode asynchronously. Prompt mode always writes a new script from the supplied material. Use POST /v1/episodes/import to preserve script text, or script mode here for a validated structured script."},"ImportedEpisodeScript":{"type":"object","properties":{"chapters":{"type":"array","items":{"$ref":"#/components/schemas/ImportedScriptChapter"},"minItems":1,"maxItems":50,"description":"Ordered script chapters. Maximum 50 chapters."}},"required":["chapters"],"additionalProperties":false,"description":"Structured script input for episode generation. Script mode skips prompt-based script writing. Limits: 75000 total text characters, 50 chapters, 200 segments per chapter, 600 total segments, and 5000 characters per segment.","example":{"chapters":[{"segments":[{"host_id":"2e6939fe","text":"Welcome to the show. Today we are talking about one small habit that can make the week easier."},{"host_id":"a91c4d22","text":"I like that. Let us start with something simple someone can try tomorrow morning."}],"title":"Opening"}]}},"ImportedScriptChapter":{"type":"object","properties":{"segments":{"type":"array","items":{"$ref":"#/components/schemas/ImportedScriptSegment"},"minItems":1,"maxItems":200,"description":"Spoken turns in this chapter. Maximum 200 segments."},"title":{"type":"string","minLength":1,"maxLength":200,"description":"Optional chapter title.","example":"Opening"}},"required":["segments"],"additionalProperties":false,"description":"A group of imported script segments. Each chapter can contain up to 200 segments.","example":{"segments":[{"host_id":"2e6939fe","text":"Welcome to the show. Today we are talking about one small habit that can make the week easier."},{"host_id":"a91c4d22","text":"I like that. Let us start with something simple someone can try tomorrow morning."}],"title":"Opening"}},"ImportedScriptSegment":{"type":"object","properties":{"host_id":{"type":"string","minLength":1,"description":"Host ID for the speaker of this segment.","example":"2e6939fe"},"text":{"type":"string","minLength":1,"maxLength":5000,"description":"Text to synthesize for this segment. Maximum 5000 characters.","example":"Welcome to the show. Today we are talking about one small habit that can make the week easier."}},"required":["host_id","text"],"additionalProperties":false,"description":"One spoken turn in an imported script. The host must belong to your organization.","example":{"host_id":"2e6939fe","text":"Welcome to the show. Today we are talking about one small habit that can make the week easier."}},"ImportEpisodeInput":{"type":"object","properties":{"podcast_id":{"type":"string","format":"uuid","description":"Podcast that will own the imported generated episode."},"outputs":{"type":"array","items":{"type":"string","enum":["audio","video"]},"maxItems":2,"description":"Files to produce: audio (MP3), video (MP4 with sound), both, or [] for an editable draft. Each requested file becomes downloadable independently. Do not combine with render. Omission preserves legacy render behavior."},"render":{"type":"boolean","description":"Deprecated: use outputs. True produces audio and video; false or omission leaves an editable draft. Do not combine with outputs.","deprecated":true},"script":{"type":"string","minLength":1,"maxLength":75000,"description":"Script or transcript text. Bracketed speaker labels match saved Characters unless speaker_characters explicitly assigns their Character IDs.","example":"[Host One]\nWelcome to the show. Today we are talking about one small habit that can make the week easier.\n\n[Host Two]\nI like that. Let us start with something simple someone can try tomorrow morning."},"speaker_characters":{"type":"array","items":{"type":"object","properties":{"character_id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1,"maxLength":200}},"required":["character_id","label"],"additionalProperties":false},"minItems":1,"maxItems":200,"description":"Optional explicit assignments for a finished script: label as written in [brackets], and character_id from list_characters. Assignments override name matching; unmapped labels still match saved Character names."}},"required":["podcast_id","script"],"additionalProperties":false,"description":"Fields for importing script or transcript text and generating a new episode asynchronously."},"UpdateEpisodeInput":{"type":"object","properties":{"description":{"type":["string","null"],"maxLength":2000},"image":{"type":["string","null"],"format":"uri"},"title":{"type":"string","minLength":1,"maxLength":255}},"additionalProperties":false,"description":"Patchable episode fields. All optional; only provided fields are updated."},"EpisodeDetail":{"type":"object","properties":{"audio_url":{"type":["string","null"],"readOnly":true},"created_at":{"type":"string","readOnly":true},"description":{"type":["string","null"]},"generation":{"type":["object","null"],"properties":{"completed_at":{"type":["string","null"]},"error_message":{"type":"string"},"started_at":{"type":"string"},"state":{"type":"string","enum":["generating","completed","failed"]},"skipped_sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":["string","null"]},"url":{"type":["string","null"]},"reason":{"type":"string"}},"required":["id","title","url","reason"]}}},"required":["completed_at","started_at","state"],"readOnly":true},"host_ids":{"type":["array","null"],"items":{"type":"string"}},"id":{"type":"string","format":"uuid","readOnly":true},"image_url":{"type":["string","null"]},"podcast_id":{"type":"string","format":"uuid"},"published_at":{"type":["string","null"],"readOnly":true},"scheduled_at":{"type":["string","null"],"readOnly":true},"source_ids":{"type":"array","items":{"type":"string","format":"uuid"},"readOnly":true},"status":{"$ref":"#/components/schemas/EpisodeStatus"},"title":{"type":["string","null"]},"updated_at":{"type":"string","readOnly":true},"url":{"type":["string","null"],"readOnly":true},"video_url":{"type":["string","null"],"readOnly":true},"outputs":{"type":"object","properties":{"audio":{"type":"object","properties":{"current":{"type":"boolean"},"download_url":{"type":["string","null"],"format":"uri"},"error":{"type":["string","null"]},"status":{"type":"string","enum":["not_requested","preparing","available","failed"]}},"required":["current","download_url","error","status"]},"video":{"type":"object","properties":{"current":{"type":"boolean"},"download_url":{"type":["string","null"],"format":"uri"},"error":{"type":["string","null"]},"status":{"type":"string","enum":["not_requested","preparing","available","failed"]}},"required":["current","download_url","error","status"]}},"required":["audio","video"]},"progress":{"$ref":"#/components/schemas/EpisodeProgress"}},"required":["audio_url","created_at","description","generation","host_ids","id","image_url","podcast_id","published_at","scheduled_at","source_ids","status","title","updated_at","url","video_url","outputs","progress"],"description":"A podcast episode with publishing metadata, audio/video URLs when available, and its production progress."},"EpisodeProgress":{"type":"object","properties":{"error":{"type":["string","null"],"description":"Why generation or rendering failed, when it did."},"needs_attention":{"type":["object","null"],"properties":{"missing_visuals":{"type":"integer","minimum":0},"skipped_sources":{"type":"integer","minimum":0},"unvoiced_lines":{"type":"integer","minimum":0}},"required":["missing_visuals","skipped_sources","unvoiced_lines"],"description":"Gaps a usable episode still has, such as lines without audio or skipped sources. Fix them in Studio; null when there are none."},"phase":{"type":["string","null"],"description":"The work still in flight, such as `rendering` or `finalizing_outputs`. Null once the episode is idle, completed, or failed."},"poll_after_seconds":{"type":"number","minimum":0,"description":"Seconds to wait before reading the episode again. Zero means it will not change on its own."},"render_required":{"type":"boolean","description":"True when the content is ready but has no playable or downloadable output and nothing is preparing one, as after a caption or watermark edit. Outputs stay unavailable until a new render or export is requested. Call `POST /episodes/{episode_id}/export` to produce one."},"status":{"type":"string","enum":["idle","generating","completed","failed"],"description":"Whether the requested episode work is still running. `completed` means generation and all requested files finished. Individual output status reports each file before the request finishes."}},"required":["error","needs_attention","phase","poll_after_seconds","render_required","status"],"description":"Where the episode stands across generation and rendering. MCP `get_content` reports the same progress.","readOnly":true},"UploadEpisodeImageResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"image_url":{"type":"string"}},"required":["id","image_url"]}},"required":["data"],"description":"The uploaded image URL."},"PublishEpisodeResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"scheduled_time":{"type":"string"},"status":{"type":"string","enum":["published","scheduled"]}},"required":["id","status"]}},"required":["data"],"description":"Result of a publish or schedule operation."},"PublishEpisodeInput":{"type":"object","properties":{"scheduled_time":{"type":"string","format":"date-time"}},"additionalProperties":false,"description":"Optional publishing options. Omit to publish immediately; provide `scheduled_time` to schedule for later."},"TimestampsJsonResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"episode_id":{"type":"string"},"speakers":{"type":"array","items":{"type":"object","properties":{"host_id":{"type":"string"},"name":{"type":"string"}},"required":["host_id","name"]}},"words":{"type":"array","items":{"type":"object","properties":{"end":{"type":"number"},"speaker":{"type":["number","null"]},"start":{"type":"number"},"text":{"type":"string"}},"required":["end","speaker","start","text"]}}},"required":["episode_id","speakers","words"]}},"required":["data"],"description":"Word-level episode timestamps with speaker attribution. Speakers are referenced by integer index into the `speakers` array."},"ListHostsResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/HostRow"}}},"required":["data"],"description":"Page of hosts. Use the `Link` response header (`rel=\"next\"`) to paginate."},"HostRow":{"type":"object","properties":{"backstory":{"type":["string","null"]},"created_at":{"type":"string","readOnly":true},"id":{"type":"string","description":"8-character hex host id (e.g. `2e6939fe`).","example":"2e6939fe","readOnly":true},"name":{"type":"string"},"personality":{"type":["string","null"]},"title":{"type":["string","null"]},"updated_at":{"type":"string","readOnly":true},"voice":{"type":["object","null"],"properties":{"accent":{"type":["string","null"]},"description":{"type":["string","null"]},"gender":{"type":"string","enum":["male","female","other"]},"id":{"type":"integer"},"language":{"type":["string","null"]},"model":{"type":["string","null"],"description":"Provider model identifier used to synthesize this voice."},"voice_type":{"type":"string","enum":["professional","clone","design"]}},"required":["accent","description","gender","id","language","model","voice_type"]},"voice_id":{"type":["integer","null"]}},"required":["backstory","created_at","id","name","personality","title","updated_at","voice","voice_id"],"description":"A host (speaker/presenter) belonging to your organization."},"CreateHostInput":{"type":"object","properties":{"backstory":{"type":"string","minLength":10,"maxLength":3000,"description":"Plain text or HTML. Plain text is returned inside <p> tags."},"image_path":{"type":"string"},"is_guest":{"type":"boolean"},"name":{"type":"string","minLength":1,"maxLength":100},"personality":{"type":"string","minLength":1,"maxLength":3000,"description":"Plain text or HTML. Plain text is returned inside <p> tags."},"title":{"type":"string","minLength":1,"maxLength":100},"voice_id":{"type":"integer"}},"required":["backstory","name","voice_id"],"additionalProperties":false,"description":"Fields required to create a host."},"UpdateHostInput":{"type":"object","properties":{"backstory":{"type":"string","minLength":10,"maxLength":3000,"description":"Plain text or HTML. Plain text is returned inside <p> tags."},"image_path":{"type":"string"},"is_guest":{"type":"boolean"},"name":{"type":"string","minLength":1,"maxLength":100},"personality":{"type":"string","minLength":1,"maxLength":3000,"description":"Plain text or HTML. Plain text is returned inside <p> tags."},"title":{"type":"string","minLength":1,"maxLength":100},"voice_id":{"type":"integer"}},"additionalProperties":false,"description":"Patchable host fields. All optional; only provided fields are updated."},"Insights":{"type":"object","properties":{"as_of":{"type":["string","null"],"description":"ISO-8601 time the saved analytics behind these numbers were captured. Null when nothing has been captured yet.","readOnly":true},"channels":{"type":"array","items":{"type":"object","properties":{"engagement":{"type":["object","null"],"properties":{"comments":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"reactions":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]}},"required":["comments","reactions"]},"followers":{"type":["object","null"],"properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"name":{"type":"string"},"network":{"type":["string","null"]},"plays":{"type":["object","null"],"properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"posts":{"type":["object","null"],"properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"source":{"type":"string","enum":["feed","player","channel"]}},"required":["engagement","followers","name","network","plays","posts","source"]},"description":"Items posted, plays, engagement, and net followers gained per source: `feed` (podcast feeds), `player` (the Jellypod player), and each connected `channel`. A null value means the source does not report it."},"complete":{"type":"boolean","description":"Whether every measured podcast has a saved analytics capture. When false the numbers are a floor rather than a total; retry later for a complete read.","readOnly":true},"period":{"type":"string","enum":["7d","30d","month","last-month","custom","last-week"]},"previous":{"type":"object","properties":{"end":{"type":"string","format":"date"},"start":{"type":"string","format":"date"}},"required":["end","start"],"description":"The equal-length period just before `range`, which every `previous` value covers."},"range":{"type":"object","properties":{"end":{"type":"string","format":"date"},"start":{"type":"string","format":"date"}},"required":["end","start"],"description":"Inclusive UTC days the `current` values cover."},"studio_url":{"type":"string","format":"uri","description":"The Studio Insights page for the same period and filter."},"summary":{"type":"object","properties":{"channels_posted":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"engagement":{"type":["object","null"],"properties":{"comments":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"reactions":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"rate":{"type":"object","properties":{"current":{"type":["number","null"]},"previous":{"type":["number","null"]}},"required":["current","previous"]}},"required":["comments","reactions","rate"]},"plays":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"published":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]},"watch_time_sec":{"type":"object","properties":{"current":{"type":"number"},"previous":{"type":"number"}},"required":["current","previous"]}},"required":["channels_posted","engagement","plays","published","watch_time_sec"],"description":"Total plays, watch time in seconds (Jellypod player and YouTube), items published, Channels posted to, and reactions and comments with their rate per play, each as `current` and `previous`. `engagement` is null when no source captured it."},"takeaways":{"type":"array","items":{"type":"object","properties":{"action":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["label","url"]},"body":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"}},"required":["action","body","id","title"]},"description":"Up to three suggested next steps for the whole library, each with a Studio action."},"top_content":{"type":"array","items":{"type":"object","properties":{"comments":{"type":["number","null"]},"id":{"type":"string"},"kind":{"type":"string","enum":["episode","video","short","voiceover"]},"plays":{"type":"number"},"published_at":{"type":["string","null"]},"reactions":{"type":["number","null"]},"title":{"type":"string"},"watch_time_sec":{"type":"number"}},"required":["comments","id","kind","plays","published_at","reactions","title","watch_time_sec"]},"description"

# --- truncated at 32 KB (262 KB total) ---
# Full source: https://artifacts.apis.io/jellypod-com/openapi/_original/jellypod-com-api-openapi.json