Create multipart upload session

Create a media record and start an S3 multipart upload session.

post/media/uploads

Headers

X-Fanvue-API-Versionstring required

Example:2025-06-26

API version to use for the request

namestring required

filenamestring required

mediaType'image' | 'video' | 'audio' | 'document' required

sizeBytesinteger

Total size of the file in bytes. When provided, the response includes the exact totalParts to upload.

Upload session created

mediaUuidstring uuid required

uploadIdstring required

partSizeinteger required

Size in bytes of every part except the final one (which may be smaller).

maxPartsinteger required

Maximum number of parts allowed, derived from the maximum supported file size.

totalPartsinteger nullable required

Exact number of parts to upload, computed from sizeBytes. Null when sizeBytes was not provided — compute it client-side as ceil(fileSize / partSize).

No recorded changes to this endpoint across all 2 revisions of this API.