v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB

Story Highlights

Update Story Highlight

Update the details of a specific story highlight by its ID.

put/api/{account}/stories/highlights/{highlight_id}

Request body

titlestring required

The new title for the story highlight. Provide the old value if you don't want to change it.

coverStoryIdinteger required

The ID of the story to use as the cover for the highlight. Provide the old value if you don't want to change it.

storyIdsstring[] required

An array of story IDs to include in the highlight. Provide the old value if you don't want to change it.

Example request

{
  "title": "My Updated Highlight",
  "coverStoryId": 9876543210,
  "storyIds": [
    1234567890,
    2345678901
  ]
}

Response

Success

Example response

{
  "data": {
    "id": 123,
    "userId": 132,
    "title": "title",
    "coverStoryId": 123,
    "cover": "https://cdn2.onlyfans.com/files/...",
    "storiesCount": 2,
    "createdAt": "2025-01-01T01:01:01+00:00"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 1000999738,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 5000,
      "limit_day": null,
      "remaining_minute": 4996,
      "remaining_day": null,
      "notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
    }
  }
}