Sign in

v1

latestOpenAPI 3.0.42026-07-2271315.1 KB
File Upload API

Generate Presigned Upload URLs

Request presigned S3 URLs for a multipart upload.

<Note>The file is split into chunks of 5 MB with one presigned URL per part.</Note>

For each part returned:

  1. Send raw bytes to S3 — PUT PresignedUrl the raw bytes of the chunk to (no auth needed).
  2. Collect the ETag from each S3 response header — These will be needed in the complete-upload endpoint.
post/open/partner/files/upload/generate-presigned-urls

Headers

Content-Typestring required

Request body

filesizeinteger required

Total size of the file, in bytes. Determines how many parts are returned.

filetypestring required

File extension of the audio file. ("mp3" or "opus")

Example request

{
  "filesize": 10485760,
  "filetype": "mp3"
}

Response

Presigned URLs issued

FileIdstring

Identifier for the file being uploaded. Pass to complete-upload.

UploadIdstring

Identifier for the multipart upload session. Pass to complete-upload.

ChunkSizeinteger

Size of each chunk, in bytes. The file should be split into chunks of this size.

Example response

{
  "FileId": "file_xxx",
  "UploadId": "upload_xxx",
  "ChunkSize": 5242880,
  "Parts": [
    {
      "PartNumber": 1,
      "PresignedUrl": "https://plaud-bucket.s3.amazonaws.com/..."
    }
  ]
}