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.

Authorization Error Codes