Skip to main content
POST
/
media
/
upload-sessions
Start media upload session
curl --request POST \
  --url https://api.woopsocial.com/v1/media/upload-sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "fileSizeInBytes": 2684354560
}
'
{
  "uploadSessionId": "<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: 1 <= x <= 5368709120

Response

200 - application/json

Upload session created.

​
uploadSessionId
string
required

Media upload session 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.