JellypodJellypod
Episodes

Publish an episode

POST
/episodes/{episode_id}/publish

Publish or schedule an episode that has completed audio generation. The episode must be in draft status with audio in its timeline.

This triggers video rendering, Mux upload, credit deduction, and publishing. Omit scheduled_time for immediate publish, or provide an ISO 8601 datetime to schedule.

Poll GET /v1/episodes/{episode_id} to track rendering progress. Once complete, the episode status changes to published or scheduled.

Authorization

BearerAuth
AuthorizationBearer <token>

Jellypod API key. Create and manage keys from the Jellypod dashboard under Settings → API Keys.

In: header

Path Parameters

episode_id*string

The episode's unique identifier.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.jellypod.com/v1/episodes/497f6eca-6276-4993-bfeb-53cbbbba6f08/publish" \  -H "Content-Type: application/json" \  -d '{}'

{
  "data": {
    "id": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
    "status": "publishing"
  }
}

Was this page helpful?

Upload episode cover image PUT

Upload or replace the episode's cover image. Send the raw image bytes as the request body with the appropriate `Content-Type` header. **Supported formats:** JPEG, PNG, WebP. **Maximum size:** 10 MB.

List episodes GET

List all episodes in the organization. Supports filtering by podcast and status.