Fanvue API Documentation

curl --request PATCH \ --url https://api.fanvue.com/creators/{creatorUserUuid}/posts/{uuid} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'X-Fanvue-API-Version: <x-fanvue-api-version>' \ --data ' { "text": "Hey, thanks so much for the support!", "mediaUuids": [ "3fa85f64-5717-4562-b3fc-2c963f66afa6" ], "mediaPreviewUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "price": 9.99, "audience": "subscribers" } '

{ "uuid": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T12:00:00.000Z", "text": "Updated post content!", "price": null, "audience": "followers-and-subscribers", "publishAt": null, "publishedAt": "2025-01-01T12:00:00.000Z", "expiresAt": null, "mediaUuids": [ "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6" ], "mediaPreviewUuid": null, "isPinned": true, "likesCount": 42, "commentsCount": 15, "tips": { "count": 8, "totalGross": 5000, "totalNet": 4250 }, "collections": [ { "uuid": "d1e2f3a4-b5c6-7890-abcd-ef1234567890", "label": "Behind the Scenes" } ] }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Fanvue-API-Version

string

default:2025-06-26

required

API version to use for the request

Example:

"2025-06-26"

Path Parameters

creatorUserUuid

string<uuid>

required

uuid

string<uuid>

required

UUID of the post to update

Body

application/json

text

string | null

Text content of the post. Set to null to remove text.

Maximum string length: 5000

mediaUuids

string<uuid>[]

Array of media UUIDs to attach to the post (replaces existing media)

mediaPreviewUuid

string<uuid> | null

UUID of free preview media shown before unlock. Set to null to remove.

price

number | null

Price in cents for paid posts. Set to null to make the post free.

Required range: x >= 300

audience

enum<string>

Audience that can view the post

Available options:

subscribers,

followers-and-subscribers

publishAt

string<date-time> | null

Future date/time to publish the post (ISO 8601 format). Set to null to publish immediately if currently scheduled.

expiresAt

string<date-time> | null

Date/time when the post expires (ISO 8601 format). Set to null to remove expiration.

collectionUuids

string<uuid>[] | null

Array of content collection UUIDs to assign to the post (replaces existing collections). Set to null to remove all collections.

Response

Post updated successfully

uuid

string<uuid>

required

Unique identifier of the post

createdAt

string<date-time>

required

Date/time when the post was created (ISO 8601 format)

text

string | null

required

Text content of the post

price

number | null

required

Price in cents for paid posts

mediaPreviewUuid

string<uuid> | null

required

UUID of free preview media

audience

enum<string>

required

Audience that can view the post

Available options:

subscribers,

followers-and-subscribers

publishAt

string<date-time> | null

required

Future date/time when the post will be published (ISO 8601 format)

publishedAt

string<date-time> | null

required

Date/time when the post was published (ISO 8601 format)

expiresAt

string<date-time> | null

required

Date/time when the post expires (ISO 8601 format)

mediaUuids

string<uuid>[]

required

Array of media UUIDs attached to the post

isPinned

boolean

required

Whether the post is pinned to the top of the feed

likesCount

number

required

Number of likes the post has received

commentsCount

number

required

Number of comments on the post

tips

object

required

Tips statistics for this post

Show child attributes

collections

object[]

required

Content collections this post belongs to

Show child attributes