Skip to main content
POST
/
open
/
partner
/
files
/
upload
/
generate-presigned-urls
Generate Presigned Upload URLs
curl --request POST \
  --url https://platform-us.plaud.ai/developer/api/open/partner/files/upload/generate-presigned-urls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "filesize": 10485760,
  "filetype": "mp3"
}
'
{
  "FileId": "file_xxx",
  "UploadId": "upload_xxx",
  "ChunkSize": 5242880,
  "Parts": [
    {
      "PartNumber": 1,
      "PresignedUrl": "https://plaud-bucket.s3.amazonaws.com/..."
    },
    {
      "PartNumber": 2,
      "PresignedUrl": "https://plaud-bucket.s3.amazonaws.com/..."
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication using a user_access_token (see the Authentication API).

Headers

Content-Type
string
default:application/json
required

Body

application/json
filesize
integer
required

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

Example:

10485760

filetype
string
required

File extension of the audio file.

Example:

"mp3"

Response

200 - application/json

Presigned URLs issued

FileId
string

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

Example:

"file_xxx"

UploadId
string

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

Example:

"upload_xxx"

ChunkSize
integer

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

Example:

5242880

Parts
object[]

One entry per chunk, each with a presigned S3 URL to PUT the chunk to.