Uploads

Start a multipart video upload

Requires the media:write scope (upload photos and videos). Send Idempotency-Key to retry safely: a repeat with the same key and body within 24 hours returns the first response.

post/v1/sites/{siteId}/videos/uploads

Request

  • Base URL: https://api.dropl.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.dropl.io/v1/sites/{siteId}/videos/uploads
  • Auth: HTTP bearer

Path parameters

siteIdstring uuid required

Headers

Idempotency-Keystring

Unique per request, up to 255 printable ASCII characters. Reusing it with a different request is a 422.

Request body

fileNamestring required
contentType'video/mp4' | 'video/quicktime' | 'video/webm' | 'video/x-matroska' | 'video/x-msvideo' | 'video/mpeg' | 'video/x-m4v' required
sizeBytesinteger required
titlestring
folderIdstring uuid nullable

Response

Success

uploadSessionIdstring uuid required
videoIdstring uuid required
publicIdstring required
partSizeBytesinteger required

Every part except the last must be exactly this size.

partCountinteger required
expiresAtstring date-time required

Changes

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