FAfanvue

Update a post

Update an existing post's properties. Only the post owner can edit their posts. 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.

Post text is checked for prohibited language and rejected with a 400 if it does not pass.

patch/posts/{uuid}

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/posts/{uuid}
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: write:post

Path parameters

uuidstring uuid required

UUID of the post to update

Headers

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

API version to use for the request

Request body

textstring nullable

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

mediaUuidsstring[]

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

mediaPreviewUuidstring uuid nullable

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

pricenumber nullable

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

audience'subscribers' | 'followers-and-subscribers'

Audience that can view the post

publishAtstring date-time nullable

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

expiresAtstring date-time nullable

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

collectionUuidsstring[] nullable

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

Response

Post updated successfully

uuidstring uuid required

Unique identifier of the post

createdAtstring date-time required

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

textstring nullable required

Text content of the post

pricenumber nullable required

Price in cents for paid posts

mediaPreviewUuidstring uuid nullable required

UUID of free preview media

audience'subscribers' | 'followers-and-subscribers' required

Audience that can view the post

publishAtstring date-time nullable required

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

publishedAtstring date-time nullable required

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

expiresAtstring date-time nullable required

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

mediaUuidsstring[] required

Array of media UUIDs attached to the post

isPinnedboolean required

Whether the post is pinned to the top of the feed

likesCountnumber required

Number of likes the post has received

commentsCountnumber required

Number of comments on the post

Changes

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