Fanvue API Documentation

curl -X PATCH https://api.fanvue.com/creators/creatorUserUuid/posts/uuid \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

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

Update an existing post on behalf of a creator. All fields are optional — only provided fields will be updated.

If a scheduled post has its publishAt set to null, it will be published immediately.

Scopes required: write:post, write:creator

Update an existing post on behalf of a creator. All fields are optional — only provided fields will be updated. If a scheduled post has its `publishAt` set to `null`, it will be published immediately. <Info>Scopes required: `write:post`, `write:creator`</Info>

Authentication

AuthorizationBearer

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

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

uuidstringRequiredformat: "uuid"

UUID of the post to update

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26

API version to use for the request

Request

This endpoint expects an object.

textstring or nullOptional<=5000 characters

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

mediaUuidslist of stringsOptional

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

mediaPreviewUuidstring or nullOptionalformat: "uuid"

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

pricedouble or nullOptional>=300

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

audienceenumOptional

Audience that can view the post

Allowed values:

publishAtstring or nullOptionalformat: "date-time"

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

expiresAtstring or nullOptionalformat: "date-time"

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

collectionUuidslist of strings or nullOptional

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

Response

Post updated successfully

uuidstringformat: "uuid"

Unique identifier of the post

createdAtstringformat: "date-time"

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

textstring or null

Text content of the post

pricedouble or null

Price in cents for paid posts

mediaPreviewUuidstring or nullformat: "uuid"

UUID of free preview media

audienceenum

Audience that can view the post

Allowed values:

publishAtstring or nullformat: "date-time"

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

publishedAtstring or nullformat: "date-time"

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

expiresAtstring or nullformat: "date-time"

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

mediaUuidslist of strings

Array of media UUIDs attached to the post

isPinnedboolean

Whether the post is pinned to the top of the feed

likesCountdouble

Number of likes the post has received

commentsCountdouble

Number of comments on the post

tipsobject

Tips statistics for this post

collectionslist of objects

Content collections this post belongs to

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

429

Too Many Requests Error