Skip to main content
POST
/
media
/
uploads
/
initiate
Error
A valid request URL is required to generate request examples
{
  "uploadId": "<string>",
  "partSizeInBytes": 123,
  "partCount": 123,
  "expiresAt": "2023-11-07T05:31:56Z",
  "parts": [
    {
      "partNumber": 2,
      "uploadUrl": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
projectId
string
required

Project that will own the uploaded media.

​
fileSizeInBytes
integer<int64>
required

Total size of the file that will be uploaded.

Required range: x >= 1

Response

200 - application/json

Multipart upload created.

​
uploadId
string
required

Application-level media upload identifier.

​
partSizeInBytes
integer<int64>
required

Maximum chunk size to use when slicing the file into parts.

For uploads with more than one part, every part except the last must be exactly this size. The last part may be smaller. For a single-part upload, the only part may be smaller than this size.

​
partCount
integer<int32>
required

Number of parts that must be uploaded before completion.

​
expiresAt
string<date-time>
required

Time when the presigned part upload URLs expire.

​
parts
object[]
required

Presigned upload targets, in part-number order.