API: Create Upload Episode
Create an episode from a previously uploaded audio file. The audio must have been uploaded to the storagePath returned by the presign endpoint. After creation, the episode will automatically be submitted for processing. Enterprise uploads use usage-based billing under the Enterprise agreement.
Endpoint
POSThttps://app.podwise.ai/api/open/v1/episodes/upload-audio
Request Body
type RequestBody = {
// Episode title (max 512 characters)
title: string;
// The storagePath returned from the presign endpoint
storagePath: string;
// File size in bytes
audioSize: number;
// Audio file extension (e.g., "mp3", "wav", "m4a")
audioType: string;
// Episode description
description?: string;
// Comma-separated keywords to improve transcription accuracy
keywords?: string;
// Comma-separated speaker names to improve transcription accuracy
authors?: string;
// Audio duration in seconds (as a string, e.g., "3600")
duration?: string;
};Response
type Response = {
success: true;
result: {
seq: number;
title: string;
episodeId: string;
podcastId: string;
};
};Enterprise Webhook
Enterprise uploads created through Open API trigger webhook callbacks. The
configured webhook receives OPEN_API_TRANSCRIBE_DONE or
OPEN_API_TRANSCRIBE_ERROR when processing finishes.
The automatic processing request registers a webhook notification with the returned episode seq. Delivery uses the webhook URL and active access token selected in the Enterprise Console.
See Webhook Notifications for payload definitions and delivery behavior.