Update Story Highlight

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

Authorization

default

AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

account*string

The Account ID

highlight_id*integer

The ID of the story highlight to retrieve

Request Body

application/json

title*string

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

coverStoryId*integer

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.

storyIds*array<string>

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

Response Body

`application/json`

curl -X PUT "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/stories/highlights/1234567890" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Updated Highlight",
    "coverStoryId": 9876543210,
    "storyIds": [
      1234567890,
      2345678901
    ]
  }'

curl -X PUT "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/stories/highlights/1234567890" \  -H "Content-Type: application/json" \  -d '{    "title": "My Updated Highlight",    "coverStoryId": 9876543210,    "storyIds": [      1234567890,      2345678901    ]  }'

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