Update a post | Fanvue API Documentation

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.

Scope required: write: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. <Info>Scope required: `write:post`</Info>

Authentication

AuthorizationBearer

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

Path parameters

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.

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

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

1	{
2	"uuid": "123e4567-e89b-12d3-a456-426614174000",
3	"createdAt": "2025-01-01T12:00:00.000Z",
4	"text": "Updated post content!",
5	"price": 1.1,
6	"mediaPreviewUuid": "string",
7	"audience": "followers-and-subscribers",
8	"publishAt": "2024-01-15T09:30:00Z",
9	"publishedAt": "2025-01-01T12:00:00.000Z",
10	"expiresAt": "2024-01-15T09:30:00Z",
11	"mediaUuids": [
12	"a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6"
13	],
14	"isPinned": true,
15	"likesCount": 42,
16	"commentsCount": 15,
17	"tips": {
18	"count": 8,
19	"totalGross": 5000,
20	"totalNet": 4250
21	},
22	"collections": [
23	{
24	"uuid": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
25	"label": "Behind the Scenes"
26	}
27	]
28	}