Skip to main content
POST
Generate Presigned Upload URLs

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. ("mp3" or "opus")

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.