v1

latestOpenAPI 3.0.42026-07-2271315.1 KB

File Upload API

Complete Multipart Upload

Merge the uploaded parts into a single file.

Submit the file_id and upload_id from generate-presigned-urls along with the ETag collected from each part's PUT response.<Note>The returned DownloadUrl is valid for 24 hours.</Note>

post/open/partner/files/upload/complete-upload

Headers

Content-Typestring required

Request body

file_idstring required

The FileId returned by generate-presigned-urls.

upload_idstring required

The UploadId returned by generate-presigned-urls.

filetypestring required

File extension of the audio file.

file_md5string

Hex-encoded MD5 of the full file, used to verify integrity. Optional.

Example request

{
  "file_id": "file_xxx",
  "upload_id": "upload_xxx",
  "part_list": [
    {
      "PartNumber": 1,
      "ETag": "\"abc123...\""
    }
  ],
  "filetype": "mp3",
  "file_md5": "9e107d9d372bb6826bd81d3542a419d6"
}

Response

Upload completed and parts merged

FileIdstring

Identifier for the uploaded file.

FileTypestring

File extension of the audio file.

DownloadUrlstring

Pre-signed download URL for the merged file, valid ~24h. Pass as file_url to the Transcription API.

FileMd5string

Hex-encoded MD5 of the merged file.

Example response

{
  "FileId": "file_xxx",
  "FileType": "mp3",
  "DownloadUrl": "https://plaud-bucket.s3.amazonaws.com/...",
  "FileMd5": "9e107d9d372bb6826bd81d3542a419d6"
}