Skip to content
Docs
Open API v1Episodes

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://app.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