API: Get Upload Audio Presigned URL

Request a presigned URL for uploading an audio file. After receiving the URL, upload your file directly via an HTTP PUT request to the returned uploadUrl.

Endpoint

POSThttps://podwise.ai/api/open/v1/episodes/upload-audio/presign

Request Body


type RequestBody = {
  // The audio file name (e.g., "episode.mp3")
  // Used to determine the storage path extension
  fileName: string,
  // The MIME type of the audio file (e.g., "audio/mpeg", "audio/wav", "audio/x-m4a")
  contentType: string,
}

Response


type Response = {
  success: true,
  result: {
    // Presigned URL for uploading the audio file via HTTP PUT. Expires in 1 hour.
    uploadUrl: string,
    // The storage path of the uploaded file. Pass this to the Create Upload Episode endpoint.
    storagePath: string,
  },
}

Upload Instructions

After receiving the presigned URL, upload your audio file using an HTTP PUT request:


curl -X PUT "<uploadUrl>" \
     -H "Content-Type: audio/mpeg" \
     --data-binary @your-audio-file.mp3

Authorization Error Codes