onlyfans 0.2.0 → 0.3.0

data/lib/onlyfans/resources/mass_messaging.rb

@@ -6,7 +6,8 @@ module Onlyfans
       # Some parameter documentations has been truncated, see
       # {Onlyfans::Models::MassMessagingRetrieveParams} for more details.
       #
-      # Get the content of a mass message.
+      # Get the content and settings of a mass message, including a message scheduled
+      # for later.
       #
       # @overload retrieve(id, account:, request_options: {})
       #
@@ -36,9 +37,10 @@ module Onlyfans
       # Some parameter documentations has been truncated, see
       # {Onlyfans::Models::MassMessagingUpdateParams} for more details.
       #
-      # Update a mass message.
+      # Update the content, recipients, media, price, or scheduled send time of an
+      # existing mass message.
       #
-      # @overload update(id, account:, text:, giphy_id: nil, locked_text: nil, media_files: nil, previews: nil, price: nil, scheduled_date: nil, user_ids: nil, user_lists: nil, request_options: {})
+      # @overload update(id, account:, text:, block_banned_words: nil, giphy_id: nil, locked_text: nil, media_files: nil, previews: nil, price: nil, scheduled_date: nil, user_ids: nil, user_lists: nil, request_options: {})
       #
       # @param id [String] Path param: The ID of the message queue item. Can be retrieved from the above st
       #
@@ -46,6 +48,8 @@ module Onlyfans
       #
       # @param text [String] Body param: The message text content
       #
+      # @param block_banned_words [Symbol, Onlyfans::Models::MassMessagingUpdateParams::BlockBannedWords] Body param: Screen `text` for OnlyFans banned words and block the update if any
+      #
       # @param giphy_id [String] Body param: The ID of the Giphy GIF to attach to the message. Get IDs from the G
       #
       # @param locked_text [Boolean] Body param: Whether the text should be shown or hidden
@@ -54,7 +58,7 @@ module Onlyfans
       #
       # @param previews [Array<String>] Body param: Array of media file upload prefixed_ids, or OF media IDs (required i
       #
-      # @param price [Integer] Body param: Price for paid content (0 or between 3-200). In case this is not zer
+      # @param price [Float] Body param: Price for paid content in USD (0 or between 3-200). In case this is
       #
       # @param scheduled_date [String] Body param: Schedule the chat message in the future (UTC timezone).
       #
@@ -82,7 +86,8 @@ module Onlyfans
         )
       end
 
-      # List the pending or recently sent mass messages in the message queue.
+      # List pending, scheduled, and recently sent mass messages. Use an item ID to
+      # retrieve, update, reschedule, delete, or unsend the message.
       #
       # @overload list(account, request_options: {})
       #
@@ -142,7 +147,7 @@ module Onlyfans
       #
       # @param account [String] The Account ID
       #
-      # @param end_date [String] The latest mass message to retrieve. Keep empty to get all. MUST BE DATE AFTER `
+      # @param end_date [String] The latest mass message to retrieve. Keep empty to get all. It must be after `st
       #
       # @param limit [Integer] Number of mass messages to return (default = 10)
       #
@@ -174,12 +179,14 @@ module Onlyfans
       # `userIds` parameters to send the same message to both lists and individual
       # users.
       #
-      # @overload send_(account, text:, excluded_lists: nil, giphy_id: nil, locked_text: nil, media_files: nil, previews: nil, price: nil, rf_guest: nil, rf_partner: nil, rf_tag: nil, save_for_later: nil, scheduled_date: nil, user_ids: nil, user_lists: nil, request_options: {})
+      # @overload send_(account, text:, block_banned_words: nil, excluded_lists: nil, giphy_id: nil, locked_text: nil, media_files: nil, previews: nil, price: nil, rf_guest: nil, rf_partner: nil, rf_tag: nil, save_for_later: nil, scheduled_date: nil, subscribed_within_last_days: nil, user_ids: nil, user_lists: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
       # @param text [String] The message text content
       #
+      # @param block_banned_words [Symbol, Onlyfans::Models::MassMessagingSendParams::BlockBannedWords] Screen `text` for OnlyFans banned words and block the send if any are found (ret
+      #
       # @param excluded_lists [Array<String>] Array of user list IDs that the mass message will NOT be sent to.
       #
       # @param giphy_id [String] The ID of the Giphy GIF to attach to the message. Get IDs from the Giphy listing
@@ -190,8 +197,8 @@ module Onlyfans
       #
       # @param previews [Array<Object>] Direct file uploads, OFAPI `ofapi_media_` IDs, OF vault IDs, or integer indices
       #
-      # @param price [Integer] Price for paid content (0 or between 3-200). In case this is not zero,
-      # \*\*mediaFi
+      # @param price [Float] Price for paid content in USD (0 or between 3-200). In case this is not zero,
+      # \*\*
       #
       # @param rf_guest [String] Array of OnlyFans Release Form Guest IDs to tag in your mass message
       #
@@ -203,6 +210,8 @@ module Onlyfans
       #
       # @param scheduled_date [String] Schedule the chat message in the future (UTC timezone).
       #
+      # @param subscribed_within_last_days [Integer] Only send to fans who subscribed within the last N calendar days (1-30, includin
+      #
       # @param user_ids [Array<String>] Array of user IDs that the mass message will be sent to.
       #
       # @param user_lists [Array<String>] Array of user list IDs that the mass message will be sent to.

data/lib/onlyfans/resources/media/uploads.rb

@@ -14,6 +14,11 @@ module Onlyfans
         # - `completed` — Upload finished, `media` and `credits_used` are included
         # - `failed` — Upload failed, `error` is included
         #
+        # Instead of polling, you can subscribe to the `media_uploads.completed` and
+        # `media_uploads.failed` webhook events. They carry the same fields as this
+        # endpoint and are only sent for async (`async=true`) uploads — synchronous
+        # uploads return their result directly.
+        #
         # @overload get_status(upload, account:, request_options: {})
         #
         # @param upload [String] The prefixed ID of the upload.
@@ -22,7 +27,7 @@ module Onlyfans
         #
         # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember0, Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember1, Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember2, Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember3]
+        # @return [Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember0, Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember1, Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember2, Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember3, Onlyfans::Models::Media::UploadGetStatusResponse::UnionMember4]
         #
         # @see Onlyfans::Models::Media::UploadGetStatusParams
         def get_status(upload, params)

data/lib/onlyfans/resources/media/vault/lists.rb

@@ -59,13 +59,18 @@ module Onlyfans
             )
           end
 
+          # Some parameter documentations has been truncated, see
+          # {Onlyfans::Models::Media::Vault::ListUpdateParams} for more details.
+          #
           # Rename a Vault list.
           #
-          # @overload update(list_id, account:, request_options: {})
+          # @overload update(list_id, account:, name:, request_options: {})
           #
-          # @param list_id [String] The ID of the list
+          # @param list_id [String] Path param: The ID of the list
           #
-          # @param account [String] The Account ID
+          # @param account [String] Path param: The Account ID
+          #
+          # @param name [String] Body param: The new name for the vault list. Must not be greater than 255 charac
           #
           # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -81,17 +86,37 @@ module Onlyfans
             @client.request(
               method: :put,
               path: ["api/%1$s/media/vault/lists/%2$s", account, list_id],
+              body: parsed,
               model: Onlyfans::Models::Media::Vault::ListUpdateResponse,
               options: options
             )
           end
 
+          # Some parameter documentations has been truncated, see
+          # {Onlyfans::Models::Media::Vault::ListListParams} for more details.
+          #
           # List your Vault lists (categories).
           #
-          # @overload list(account, limit: nil, offset: nil, query: nil, request_options: {})
+          # Every response carries an `ETag` computed over the `data` payload. Send it back
+          # as `If-None-Match` on your next call and you will get a `304 Not Modified` with
+          # an empty body when nothing changed, so you can keep serving your cached copy
+          # instead of re-parsing the full list. Credits are debited either way — we still
+          # have to ask OnlyFans for the current state to know whether it changed.
+          #
+          # The `ETag` covers `data` only, never `_meta` — your credits balance changes on
+          # every call, so including it would mean the `ETag` never matches. Because a `304`
+          # has no body, it also has no `_meta`: read the current credits and rate-limit
+          # counters from the `X-OFAPI-Credits-Used`, `X-OFAPI-Credits-Balance`,
+          # `X-Rate-Limit-Limit-Minute` and `X-Rate-Limit-Remaining-Minute` response
+          # headers, which are sent on `304` responses too. The `_meta` inside a body you
+          # cached earlier is stale by definition.
+          #
+          # @overload list(account, lightweight: nil, limit: nil, offset: nil, query: nil, request_options: {})
           #
           # @param account [String] The Account ID
           #
+          # @param lightweight [Boolean] Set to `true` to return only `id`, `name`, `type`, `canUpdate` and a rolled-up `
+          #
           # @param limit [Integer] Number of media to return per page. Default: `24`
           #
           # @param offset [Integer] The offset used for pagination. Default `0`
@@ -100,7 +125,7 @@ module Onlyfans
           #
           # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Onlyfans::Models::Media::Vault::ListListResponse]
+          # @return [Onlyfans::Models::Media::Vault::ListListResponse::UnionMember0, Onlyfans::Models::Media::Vault::ListListResponse::UnionMember1]
           #
           # @see Onlyfans::Models::Media::Vault::ListListParams
           def list(account, params = {})

data/lib/onlyfans/resources/media.rb

@@ -12,11 +12,18 @@ module Onlyfans
       # Some parameter documentations has been truncated, see
       # {Onlyfans::Models::MediaDownloadParams} for more details.
       #
-      # Downloads a file directly from a `https://cdn*.onlyfans.com/*` URL. When the
-      # file is already cached on our CDN, this endpoint returns a `302` redirect to a
-      # `https://cdn.fansapi.com/*` URL. Most HTTP clients follow redirects
-      # automatically (`curl` requires `-L`). Otherwise, the file is streamed through
-      # our proxies and queued for caching.
+      # Downloads a file from a `https://cdn*.onlyfans.com/*` URL through a `302`
+      # redirect. Follow redirects (`curl -L`). Cached `cdn.fansapi.com` files are free;
+      # otherwise `dl.fansapi.com` streams through the account proxy. Send one
+      # `Range: bytes=start-end` header to request a chunk for playback or a preview. A
+      # supported range returns `206`, `Content-Range`, and the chunk Content-Length; an
+      # upstream that ignores Range can return a full `200`, so check the response. Each
+      # nonempty transfer costs 3 credits per decimal MB streamed (minimum 1 credit).
+      # Credits for the selected response are reserved before streaming; unused reserved
+      # credits are released on completion, including an interrupted transfer. HEAD
+      # follows the same redirects and returns metadata without a body or download
+      # charge. HEAD does not populate the media cache. This regular endpoint does not
+      # decrypt DRM media.
       #
       # @overload download(cdn_url, account:, request_options: {})
       #
@@ -27,7 +34,7 @@ module Onlyfans
       #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [String]
+      # @return [nil]
       #
       # @see Onlyfans::Models::MediaDownloadParams
       def download(cdn_url, params)
@@ -39,8 +46,7 @@ module Onlyfans
         @client.request(
           method: :get,
           path: ["api/%1$s/media/download/%2$s", account, cdn_url],
-          headers: {"accept" => "text/plain"},
-          model: String,
+          model: NilClass,
           options: options
         )
       end

data/lib/onlyfans/resources/messages.rb

@@ -3,45 +3,6 @@
 module Onlyfans
   module Resources
     class Messages
-      # Some parameter documentations has been truncated, see
-      # {Onlyfans::Models::MessageAttachTagsParams} for more details.
-      #
-      # Attach Tags (Release Forms) to a message that has already been sent. Please
-      # note, that this is a "sync" operation - for example, if you provide empty
-      # `rfTag` it will remove all existing tags already attached to the message.
-      #
-      # @overload attach_tags(message_id, account:, rf_guest: nil, rf_partner: nil, rf_tag: nil, request_options: {})
-      #
-      # @param message_id [String] Path param: The ID of the message to attach the release forms to. This can be ON
-      #
-      # @param account [String] Path param: The Account ID
-      #
-      # @param rf_guest [String] Body param: Array of OnlyFans Release Form Guest IDs to tag in your message
-      #
-      # @param rf_partner [String] Body param: Array of OnlyFans Release Form Partners IDs to tag in your message
-      #
-      # @param rf_tag [String] Body param: Array of OnlyFans Creator User IDs to tag in your message
-      #
-      # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [Onlyfans::Models::MessageAttachTagsResponse]
-      #
-      # @see Onlyfans::Models::MessageAttachTagsParams
-      def attach_tags(message_id, params)
-        parsed, options = Onlyfans::MessageAttachTagsParams.dump_request(params)
-        account =
-          parsed.delete(:account) do
-            raise ArgumentError.new("missing required path argument #{_1}")
-          end
-        @client.request(
-          method: :post,
-          path: ["api/%1$s/messages/%2$s/attach-tags", account, message_id],
-          body: parsed,
-          model: Onlyfans::Models::MessageAttachTagsResponse,
-          options: options
-        )
-      end
-
       # @api private
       #
       # @param client [Onlyfans::Client]

data/lib/onlyfans/resources/notifications.rb

@@ -21,7 +21,7 @@ module Onlyfans
       #
       # @param limit [Integer] The number of notifications. Default `10`
       #
-      # @param skip_users [Symbol, Onlyfans::Models::NotificationListParams::SkipUsers] Whether to skip user details. Default `all`
+      # @param skip_users [Symbol, Onlyfans::Models::NotificationListParams::SkipUsers] Whether to skip user details. Defaults to `all`.
       #
       # @param type [Symbol, Onlyfans::Models::NotificationListParams::Type] Filter notifications by a specific type
       #

data/lib/onlyfans/resources/posts.rb

@@ -16,12 +16,14 @@ module Onlyfans
       #
       # Compose and send a new post to your OnlyFans account.
       #
-      # @overload create(account, text:, expire_days: nil, fund_raising_target_amount: nil, fund_raising_tips_presets: nil, label_ids: nil, media_files: nil, previews: nil, rf_tag: nil, save_for_later: nil, scheduled_date: nil, voting_correct_index: nil, voting_due: nil, voting_options: nil, voting_type: nil, request_options: {})
+      # @overload create(account, text:, block_banned_words: nil, expire_days: nil, fund_raising_target_amount: nil, fund_raising_tips_presets: nil, label_ids: nil, media_files: nil, previews: nil, rf_tag: nil, save_for_later: nil, scheduled_date: nil, voting_correct_index: nil, voting_due: nil, voting_options: nil, voting_type: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
       # @param text [String] The post text content
       #
+      # @param block_banned_words [Symbol, Onlyfans::Models::PostCreateParams::BlockBannedWords] Screen `text` for OnlyFans banned words and block the post if any are found (ret
+      #
       # @param expire_days [Integer] Number of days after which the post will expire. Between 1 and 30 days. Keep emp
       #
       # @param fund_raising_target_amount [Integer] Add a fundraising target to your post. If present, value must be at least 10.
@@ -96,7 +98,7 @@ module Onlyfans
       #
       # Update a posted, queued, or "saved for later" post.
       #
-      # @overload update(post_id, account:, text:, expire_days: nil, fund_raising_target_amount: nil, fund_raising_tips_presets: nil, label_ids: nil, media_files: nil, price: nil, rf_tag: nil, save_for_later: nil, scheduled_date: nil, voting_correct_index: nil, voting_due: nil, voting_options: nil, voting_type: nil, request_options: {})
+      # @overload update(post_id, account:, text:, block_banned_words: nil, expire_days: nil, fund_raising_target_amount: nil, fund_raising_tips_presets: nil, label_ids: nil, media_files: nil, price: nil, rf_tag: nil, save_for_later: nil, scheduled_date: nil, voting_correct_index: nil, voting_due: nil, voting_options: nil, voting_type: nil, request_options: {})
       #
       # @param post_id [Integer] Path param: The ID of the post
       #
@@ -104,6 +106,8 @@ module Onlyfans
       #
       # @param text [String] Body param: The post text content
       #
+      # @param block_banned_words [Symbol, Onlyfans::Models::PostUpdateParams::BlockBannedWords] Body param: Screen `text` for OnlyFans banned words and block the update if any
+      #
       # @param expire_days [Integer] Body param: Number of days after which the post will expire. Between 1 and 30 da
       #
       # @param fund_raising_target_amount [Integer] Body param: Add a fundraising target to your post. If present, value must be at

data/lib/onlyfans/resources/queue.rb

@@ -6,19 +6,22 @@ module Onlyfans
       # Some parameter documentations has been truncated, see
       # {Onlyfans::Models::QueueListParams} for more details.
       #
-      # List posts and messages in the queue.
+      # List scheduled posts and mass messages for a date range. Use the type filter to
+      # return only posts, messages, or both.
       #
-      # @overload list(account, limit:, publish_date_end:, publish_date_start:, timezone:, request_options: {})
+      # @overload list(account, publish_date_end:, publish_date_start:, timezone:, limit: nil, type: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
-      # @param limit [Integer] Maximum number of queue items to return (default = 20)
+      # @param publish_date_end [String] Latest publish date to return. Must be a valid date. Must be a valid date. Must
       #
-      # @param publish_date_end [String] Latest publish date to return
+      # @param publish_date_start [String] Earliest publish date to return (must be at least today). Must be a valid date.
       #
-      # @param publish_date_start [String] Earliest publish date to return (must be at least today)
+      # @param timezone [String] Timezone of the provided dates. [View available timezone values](https://www.php
       #
-      # @param timezone [String] Time timezone of the provided dates. [View available timezone values](https://ww
+      # @param limit [Integer] Maximum number of queue items to return (default 20). Must be at least 1. Must n
+      #
+      # @param type [Array<Symbol, Onlyfans::Models::QueueListParams::Type>]
       #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/onlyfans/resources/release_forms.rb

@@ -57,7 +57,8 @@ module Onlyfans
       #
       # Get a paginated list of users that can be tagged in release forms. These are
       # verified creators who have signed release forms to appear in your content. Use
-      # `offset` and `limit` for pagination.
+      # `offset` and `limit` for pagination, following `_pagination.next_page` until it
+      # is `null`.
       #
       # @overload list_taggable_users(account, filter: nil, limit: nil, name: nil, offset: nil, sort: nil, sort_direction: nil, request_options: {})
       #

data/lib/onlyfans/resources/shared_tracking_links.rb

@@ -16,16 +16,23 @@ module Onlyfans
       # List all Tracking Links (campaigns) shared with the account by other OF
       # creators. Calls OnlyFans live and syncs to our cache.
       #
-      # @overload list(account, limit: nil, offset: nil, synchronous: nil, request_options: {})
+      # @overload list(account, limit: nil, offset: nil, pagination: nil, sorting_deleted: nil, stats: nil, synchronous: nil, with_deleted: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
-      # @param limit [Integer] The number of shared tracking links to return. Default `10`
+      # @param limit [Integer] The number of shared tracking links to return. Default `10`. Must be at least 1.
       #
-      # @param offset [Integer] The offset used for pagination. Default `0`
+      # @param offset [Integer] The offset used for pagination. Default `0`. Must be at least 0.
       #
-      # @param synchronous [Boolean, nil] Wait for the database sync to finish, instead of running it in the
-      # background. \*
+      # @param pagination [Integer, Onlyfans::Models::SharedTrackingLinkListParams::Pagination] Whether pagination metadata is enabled. Default `1`.
+      #
+      # @param sorting_deleted [Integer, Onlyfans::Models::SharedTrackingLinkListParams::SortingDeleted] Whether deleted links participate in sorting. Default `1`.
+      #
+      # @param stats [String] Whether statistics are included. Default `true`. Must not be greater than 10 cha
+      #
+      # @param synchronous [Boolean] Wait for the database sync instead of processing it in the background.
+      #
+      # @param with_deleted [Integer, Onlyfans::Models::SharedTrackingLinkListParams::WithDeleted] Whether to include deleted shared tracking links. Default `1`.
       #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/onlyfans/resources/shared_trial_links.rb

@@ -16,16 +16,17 @@ module Onlyfans
       # List all Free Trial Links shared with the account by other OF creators. Calls
       # OnlyFans live and syncs to our cache.
       #
-      # @overload list(account, limit: nil, offset: nil, synchronous: nil, request_options: {})
+      # @overload list(account, limit: nil, offset: nil, pagination: nil, synchronous: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
-      # @param limit [Integer] The number of shared trial links to return. Default `10`
+      # @param limit [Integer] The number of shared trial links to return. Default `10`. Must be at least 1. Mu
       #
-      # @param offset [Integer] The offset used for pagination. Default `0`
+      # @param offset [Integer] The offset used for pagination. Default `0`. Must be at least 0.
       #
-      # @param synchronous [Boolean, nil] Wait for the database sync to finish, instead of running it in the
-      # background. \*
+      # @param pagination [Integer, Onlyfans::Models::SharedTrialLinkListParams::Pagination]
+      #
+      # @param synchronous [Boolean] Wait for the database sync instead of processing it in the background.
       #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/onlyfans/resources/smart_link_postbacks.rb

@@ -9,13 +9,19 @@ module Onlyfans
       #
       # Create a postback that fires for selected Smart Link conversion types
       #
-      # @overload create(conversion_types:, smart_link_scope:, url:, smart_link_ids: nil, request_options: {})
+      # @overload create(conversion_types:, smart_link_scope:, url:, body: nil, headers: nil, http_method: nil, smart_link_ids: nil, request_options: {})
       #
       # @param conversion_types [Array<String>] One or more Smart Link conversion types that should trigger this postback.
       #
       # @param smart_link_scope [Symbol, Onlyfans::Models::SmartLinkPostbackCreateParams::SmartLinkScope] `global` fires for all Smart Links. `campaign_specific` fires only for selected
       #
-      # @param url [String] The destination URL. Variables such as `{click_id}`, `{fbclid}`, `{gclid}`, and
+      # @param url [String] The destination URL. Variables such as `{external_click_id}`, `{fbclid}`, `{gcli
+      #
+      # @param body [String] Optional request body template for POST postbacks. Variables are replaced when t
+      #
+      # @param headers [Array<Onlyfans::Models::SmartLinkPostbackCreateParams::Header>] Optional request headers. Header values may include postback variables.
+      #
+      # @param http_method [Symbol, Onlyfans::Models::SmartLinkPostbackCreateParams::HTTPMethod] HTTP method used for the postback request. Defaults to `GET` when omitted.
       #
       # @param smart_link_ids [Array<String>] Smart Link ULIDs. Required when `smart_link_scope` is `campaign_specific`.
       #
@@ -55,9 +61,12 @@ module Onlyfans
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Onlyfans::Models::SmartLinkPostbackUpdateParams} for more details.
+      #
       # Update a Smart Link postback configuration
       #
-      # @overload update(postback_id, conversion_types:, smart_link_scope:, url:, smart_link_ids: nil, request_options: {})
+      # @overload update(postback_id, conversion_types:, smart_link_scope:, url:, body: nil, headers: nil, http_method: nil, smart_link_ids: nil, request_options: {})
       #
       # @param postback_id [Integer] The postback ID
       #
@@ -67,6 +76,12 @@ module Onlyfans
       #
       # @param url [String] The destination URL.
       #
+      # @param body [String] Optional request body template for POST postbacks. Variables are replaced when t
+      #
+      # @param headers [Array<Onlyfans::Models::SmartLinkPostbackUpdateParams::Header>] Optional request headers. Header values may include postback variables.
+      #
+      # @param http_method [Symbol, Onlyfans::Models::SmartLinkPostbackUpdateParams::HTTPMethod] HTTP method used for the postback request. Existing value is kept when omitted.
+      #
       # @param smart_link_ids [Array<String>] Smart Link ULIDs. Required when `smart_link_scope` is `campaign_specific`.
       #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/onlyfans/resources/smart_links.rb

@@ -62,18 +62,20 @@ module Onlyfans
       #
       # List all Smart Links
       #
-      # @overload list(account_ids: nil, limit: nil, meta_pixel_ids: nil, name: nil, offset: nil, request_options: {})
+      # @overload list(account_ids: nil, filter: nil, limit: nil, name: nil, offset: nil, pixel_ids: nil, request_options: {})
       #
       # @param account_ids [String, nil] Comma-separated account prefixed IDs to include.
       #
-      # @param limit [Integer] The number of Smart Links to return. Default `50`. Must be at least 1. Must not
+      # @param filter [Onlyfans::Models::SmartLinkListParams::Filter]
       #
-      # @param meta_pixel_ids [String, nil] Comma-separated Meta Pixel IDs to include.
+      # @param limit [Integer] The number of Smart Links to return. Default `50`. Must be at least 1. Must not
       #
       # @param name [String, nil] Filter Smart Links by name. Must not be greater than 255 characters.
       #
       # @param offset [Integer] The offset used for pagination. Default `0`. Must be at least 0.
       #
+      # @param pixel_ids [String, nil] Comma-separated ad platform Pixel IDs to include.
+      #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Onlyfans::Models::SmartLinkListResponse]
@@ -186,10 +188,13 @@ module Onlyfans
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Onlyfans::Models::SmartLinkListFansParams} for more details.
+      #
       # Query attributed Smart Link fans with aggregate fan metrics and subscriber
       # attribution metadata
       #
-      # @overload list_fans(smart_link_id, has_messages: nil, limit: nil, min_messages_sent_by_fan: nil, min_revenue_net: nil, min_tips_net: nil, offset: nil, sort: nil, request_options: {})
+      # @overload list_fans(smart_link_id, has_messages: nil, limit: nil, min_messages_sent_by_fan: nil, min_revenue_net: nil, min_tips_net: nil, offset: nil, previously_subscribed: nil, sort: nil, subscribed_using_promo: nil, request_options: {})
       #
       # @param smart_link_id [String] The ID of the smart link.
       #
@@ -205,8 +210,12 @@ module Onlyfans
       #
       # @param offset [Integer] Offset for pagination. Default `0`
       #
+      # @param previously_subscribed [Boolean] Optional - Filter to returning subscribers (fans previously subscribed before th
+      #
       # @param sort [Symbol, Onlyfans::Models::SmartLinkListFansParams::Sort] Optional sort field. Default `-revenue_net`
       #
+      # @param subscribed_using_promo [Boolean] Optional - Filter to fans who subscribed via a promotion/offer
+      #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Onlyfans::Models::SmartLinkListFansResponse]

data/lib/onlyfans/resources/statistics/reach.rb

@@ -15,7 +15,7 @@ module Onlyfans
         #
         # @param end_date [String] The end date for the period.
         #
-        # @param start_date [String] The start date for the period
+        # @param start_date [String] The start date for the period.
         #
         # @param filter [Symbol, Onlyfans::Models::Statistics::ReachGetProfileVisitorsParams::Filter, nil] Optionally, filter the results by `chart` or `topCountries`. See example respons
         #

data/lib/onlyfans/resources/statistics/statements.rb

@@ -6,14 +6,14 @@ module Onlyfans
       class Statements
         # Get the earnings for a given period.
         #
-        # @overload get_earnings(account, start_date:, end_date: nil, type: nil, request_options: {})
+        # @overload get_earnings(account, end_date:, start_date:, type: nil, request_options: {})
         #
         # @param account [String] The Account ID
         #
-        # @param start_date [String] The start date for the period
-        #
         # @param end_date [String] The end date for the period.
         #
+        # @param start_date [String] The start date for the period.
+        #
         # @param type [Symbol, Onlyfans::Models::Statistics::StatementGetEarningsParams::Type] Filter by All / Subscriptions / Tips / Posts / Messages / Streams
         #
         # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/onlyfans/resources/statistics.rb

@@ -11,7 +11,7 @@ module Onlyfans
 
       # Calculate the total transactions and amounts.
       #
-      # @overload calculate_total_transactions(account, end_date:, start_date:, request_options: {})
+      # @overload calculate_total_transactions(account, end_date: nil, start_date: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
@@ -24,7 +24,7 @@ module Onlyfans
       # @return [Onlyfans::Models::StatisticCalculateTotalTransactionsResponse]
       #
       # @see Onlyfans::Models::StatisticCalculateTotalTransactionsParams
-      def calculate_total_transactions(account, params)
+      def calculate_total_transactions(account, params = {})
         parsed, options = Onlyfans::StatisticCalculateTotalTransactionsParams.dump_request(params)
         query = Onlyfans::Internal::Util.encode_query_params(parsed)
         @client.request(
@@ -75,7 +75,7 @@ module Onlyfans
       # subscriptions for a specified timeframe. `unknown_subscriptions` indicates
       # deleted fan accounts.
       #
-      # @overload get_subscriber_metrics(account, end_date:, start_date:, detailed: nil, request_options: {})
+      # @overload get_subscriber_metrics(account, end_date:, start_date:, detailed: nil, detailed_type: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
@@ -85,6 +85,8 @@ module Onlyfans
       #
       # @param detailed [Boolean, nil] Include paid and free fan metrics. Will slow down the response time, and might t
       #
+      # @param detailed_type [Symbol, Onlyfans::Models::StatisticGetSubscriberMetricsParams::DetailedType, nil] Use only with `detailed=true` - otherwise, it has no effect. Filter the subscrib
+      #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Onlyfans::Models::StatisticGetSubscriberMetricsResponse]

data/lib/onlyfans/resources/stories.rb

@@ -8,16 +8,23 @@ module Onlyfans
       # @return [Onlyfans::Resources::Stories::Highlights]
       attr_reader :highlights
 
-      # Some parameter documentations has been truncated, see
-      # {Onlyfans::Models::StoryCreateParams} for more details.
+      # Post a new media or vault file to your story, optionally with text overlays,
+      # @mentions, and a question sticker. Overlay elements are rendered by OnlyFans on
+      # top of your story media at view time.
       #
-      # Post a new media or vault file to your story.
-      #
-      # @overload create(account, media_files:, request_options: {})
+      # @overload create(account, media_files:, canvas_height: nil, canvas_width: nil, question: nil, texts: nil, request_options: {})
       #
       # @param account [String] The Account ID
       #
-      # @param media_files [Array<String>] Array of media file upload prefixed_ids, or OF media IDs (required if price is n
+      # @param media_files [Array<String>] Array of media file upload prefixed_ids, or OF vault media IDs.
+      #
+      # @param canvas_height [Integer] Canvas height overlay positions are relative to. Default `1920`.
+      #
+      # @param canvas_width [Integer] Canvas width overlay positions are relative to. Default `1080`.
+      #
+      # @param question [Onlyfans::Models::StoryCreateParams::Question] Interactive question sticker viewers can answer.
+      #
+      # @param texts [Array<Onlyfans::Models::StoryCreateParams::Text>] Text and @mention overlays.
       #
       # @param request_options [Onlyfans::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/onlyfans/resources/tracking_links/tags.rb

@@ -3,7 +3,11 @@
 module Onlyfans
   module Resources
     class TrackingLinks
-      # APIs for managing tracking links
+      # APIs for managing tracking links. Revenue totals are net earnings after refunds
+      # and chargebacks. `revenue.chargebacks` (or `summary.chargebacks_total` in stats)
+      # is the positive cached net amount already excluded from revenue; do not subtract
+      # it again. Spender responses include chargebacks across all attributed periods
+      # for each fan with positive net revenue.
       class Tags
         # Get tags for a specific tracking link. This is a free endpoint.
         #