latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Create multipart upload session for creator

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

post/creators/{creatorUserUuid}/media/uploads

Path parameters

creatorUserUuidstring uuid required

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

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.

Response

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