Fanvue API Documentation

curl -X DELETE https://api.fanvue.com/creators/creatorUserUuid/posts/uuid/pin \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "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"
    }
  ]
}

Unpin a post on behalf of a creator so it returns to normal feed ordering.

Scopes required: write:post, write:creator

Unpin a post on behalf of a creator so it returns to normal feed ordering. <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 unpin

Headers

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

API version to use for the request

Response

Post unpinned 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