Media

Start media upload session

This endpoint can be used to upload both smaller and larger files (up to 5GB) in a chunked manner. Calling this creates an upload session and returns presigned URLs for uploading the file in parts.

Upload the file in partCount parts, using the matching parts[n].uploadUrl for each part number.

Every part except the last must be exactly partSizeInBytes bytes. The last part may be smaller. After all parts have been uploaded, call /media/upload-sessions/{uploadSessionId}/complete to finalize the upload and create the media item.

post/media/upload-sessions

Request

  • Base URL: https://api.woopsocial.com/v1
  • URL: https://api.woopsocial.com/v1/media/upload-sessions
  • Auth: HTTP bearer

Request body

fileSizeInBytesinteger required

Total size of the file that will be uploaded.

projectIdstring required

Project that will own the uploaded media.

Response

Upload session created.

expiresAtstring date-time required

Time when the presigned part upload URLs expire.

partCountinteger required

Number of parts that must be uploaded before completion.

partSizeInBytesinteger 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.

uploadSessionIdstring required

Media upload session identifier.

Changes

No recorded changes to this operation across all 1 revision of this API.