FAfanvue

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

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/media/uploads
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: write:creator, write:media

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

Use "audio" for a voice note — it has no media type of its own.

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

Changes

No recorded changes to this operation across all 8 revisions of this API.