late-sdk 0.0.833 → 0.0.835

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4e50ad88580b0384b74e9e6d81f30de09a8733d791ce399e2999f25551d2d1e
-  data.tar.gz: 2cc8206621298cdb44c2cb87f4a82dfc0781556492b318bc9bbd4f97e402bcc8
+  metadata.gz: fb59657c3f14b333a6c07ee99f8ac1336ed74d85413ac135a83ff80ed287bb3a
+  data.tar.gz: 6c86bde148061742173f97d113341cdafd65364d2ac6f382b73eaa566e97497a
 SHA512:
-  metadata.gz: a8202c500aeacefc3118008620a7c6fe911b1e397d7ce42b53bb1985d47bc9b96a821869ee8669065404355b2ac0640e2badade444b792cd2d98ee6b125d7711
-  data.tar.gz: 4304660e353ac16f22c09f7a8c8c425580e5740a2d2b0859e5064346124d207bf8c8a5f6859219c9ce1711dab2973a80ad7018cb1a5e62e9e524522b4e9fe2b0
+  metadata.gz: 780b7fc05b906ede71458307f281e9b2dd675cbddd8f97e53c122529b3182204ebe8dbb967b0a54dc1a8b025c2eb96c8a337d6a075549c295915cb972870d660
+  data.tar.gz: c1e2ec4f0dfb92deb5b1675f288d7e96f6c366bdf87be6aef2efca7bb229f3ca86ccf6ff42eb0bb84f66675422f57c9e9a394bf9bfd94765b59233f4e96da828

data/README.md

@@ -1191,6 +1191,7 @@ Class | Method | HTTP request | Description
  - [Zernio::GetAdsTimeline202Response](docs/GetAdsTimeline202Response.md)
  - [Zernio::GetAllAccountsHealth200Response](docs/GetAllAccountsHealth200Response.md)
  - [Zernio::GetAllAccountsHealth200ResponseAccountsInner](docs/GetAllAccountsHealth200ResponseAccountsInner.md)
+ - [Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction](docs/GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction.md)
  - [Zernio::GetAllAccountsHealth200ResponseSummary](docs/GetAllAccountsHealth200ResponseSummary.md)
  - [Zernio::GetAnalytics200Response](docs/GetAnalytics200Response.md)
  - [Zernio::GetAnalytics400Response](docs/GetAnalytics400Response.md)
@@ -1999,7 +2000,6 @@ Class | Method | HTTP request | Description
  - [Zernio::SendInboxMessageRequestTemplateElementsInner](docs/SendInboxMessageRequestTemplateElementsInner.md)
  - [Zernio::SendInboxMessageRequestTemplateElementsInnerButtonsInner](docs/SendInboxMessageRequestTemplateElementsInnerButtonsInner.md)
  - [Zernio::SendPrivateReplyToComment200Response](docs/SendPrivateReplyToComment200Response.md)
- - [Zernio::SendPrivateReplyToComment400Response](docs/SendPrivateReplyToComment400Response.md)
  - [Zernio::SendPrivateReplyToCommentRequest](docs/SendPrivateReplyToCommentRequest.md)
  - [Zernio::SendPrivateReplyToCommentRequestButtonsInner](docs/SendPrivateReplyToCommentRequestButtonsInner.md)
  - [Zernio::SendPrivateReplyToCommentRequestButtonsInnerOneOf](docs/SendPrivateReplyToCommentRequestButtonsInnerOneOf.md)

data/docs/CommentsApi.md

@@ -631,7 +631,7 @@ end
 
 Send private reply
 
-Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. 
+Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. When the comment's single private reply is spent (by this call or an earlier one) the 400 carries `details.privateReplyConsumed: true`; never retry it. 
 
 ### Examples
 

data/docs/ErrorResponse.md

@@ -10,7 +10,7 @@
 | **param** | **String** | The request field that caused the error, when applicable. | [optional] |
 | **platform** | **String** | Upstream platform (e.g. meta, google, tiktok) — present when type is platform_error. | [optional] |
 | **platform_error** | **Hash<String, Object>** | Raw error payload from the upstream platform, passed through verbatim so integrators can read provider-specific codes. For Meta this includes error_subcode, error_user_title, and error_user_msg.  | [optional] |
-| **details** | **Hash<String, Object>** | Additional structured context (e.g. field-level validation errors). | [optional] |
+| **details** | **Hash<String, Object>** | Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent. | [optional] |
 
 ## Example
 

data/docs/GetAccountHealth200Response.md

@@ -13,6 +13,7 @@
 | **permissions** | [**GetAccountHealth200ResponsePermissions**](GetAccountHealth200ResponsePermissions.md) |  | [optional] |
 | **issues** | **Array<String>** | List of issues found | [optional] |
 | **recommendations** | **Array<String>** | Actionable recommendations to fix issues | [optional] |
+| **messaging_restriction** | [**GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction**](GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction.md) |  | [optional] |
 | **platform_connection** | [**GetAccountHealth200ResponsePlatformConnection**](GetAccountHealth200ResponsePlatformConnection.md) |  | [optional] |
 
 ## Example
@@ -30,6 +31,7 @@ instance = Zernio::GetAccountHealth200Response.new(
   permissions: null,
   issues: null,
   recommendations: null,
+  messaging_restriction: null,
   platform_connection: null
 )
 ```

data/docs/GetAllAccountsHealth200ResponseAccountsInner.md

@@ -16,6 +16,7 @@
 | **token_expires_at** | **Time** |  | [optional] |
 | **needs_reconnect** | **Boolean** |  | [optional] |
 | **issues** | **Array<String>** |  | [optional] |
+| **messaging_restriction** | [**GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction**](GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction.md) |  | [optional] |
 
 ## Example
 
@@ -34,7 +35,8 @@ instance = Zernio::GetAllAccountsHealth200ResponseAccountsInner.new(
   token_valid: null,
   token_expires_at: null,
   needs_reconnect: null,
-  issues: null
+  issues: null,
+  messaging_restriction: null
 )
 ```
 

data/docs/GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction.md

@@ -0,0 +1,24 @@
+# Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **subcode** | **Integer** |  | [optional] |
+| **message** | **String** |  | [optional] |
+| **first_seen_at** | **Time** |  | [optional] |
+| **last_seen_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction.new(
+  subcode: null,
+  message: null,
+  first_seen_at: null,
+  last_seen_at: null
+)
+```
+

data/lib/zernio-sdk/api/comments_api.rb

@@ -690,7 +690,7 @@ module Zernio
     end
 
     # Send private reply
-    # Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. 
+    # Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. When the comment's single private reply is spent (by this call or an earlier one) the 400 carries `details.privateReplyConsumed: true`; never retry it. 
     # @param post_id [String] The media/post ID (Instagram media ID or Facebook post ID)
     # @param comment_id [String] The comment ID to send a private reply to
     # @param send_private_reply_to_comment_request [SendPrivateReplyToCommentRequest] 
@@ -702,7 +702,7 @@ module Zernio
     end
 
     # Send private reply
-    # Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. 
+    # Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. When the comment's single private reply is spent (by this call or an earlier one) the 400 carries `details.privateReplyConsumed: true`; never retry it. 
     # @param post_id [String] The media/post ID (Instagram media ID or Facebook post ID)
     # @param comment_id [String] The comment ID to send a private reply to
     # @param send_private_reply_to_comment_request [SendPrivateReplyToCommentRequest] 

data/lib/zernio-sdk/models/error_response.rb

@@ -34,7 +34,7 @@ module Zernio
     # Raw error payload from the upstream platform, passed through verbatim so integrators can read provider-specific codes. For Meta this includes error_subcode, error_user_title, and error_user_msg. 
     attr_accessor :platform_error
 
-    # Additional structured context (e.g. field-level validation errors).
+    # Additional structured context (e.g. field-level validation errors), for example `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's single reply is already spent.
     attr_accessor :details
 
     class EnumAttributeValidator

data/lib/zernio-sdk/models/get_account_health200_response.rb

@@ -36,6 +36,8 @@ module Zernio
     # Actionable recommendations to fix issues
     attr_accessor :recommendations
 
+    attr_accessor :messaging_restriction
+
     attr_accessor :platform_connection
 
     class EnumAttributeValidator
@@ -72,6 +74,7 @@ module Zernio
         :'permissions' => :'permissions',
         :'issues' => :'issues',
         :'recommendations' => :'recommendations',
+        :'messaging_restriction' => :'messagingRestriction',
         :'platform_connection' => :'platformConnection'
       }
     end
@@ -98,6 +101,7 @@ module Zernio
         :'permissions' => :'GetAccountHealth200ResponsePermissions',
         :'issues' => :'Array<String>',
         :'recommendations' => :'Array<String>',
+        :'messaging_restriction' => :'GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction',
         :'platform_connection' => :'GetAccountHealth200ResponsePlatformConnection'
       }
     end
@@ -164,6 +168,10 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'messaging_restriction')
+        self.messaging_restriction = attributes[:'messaging_restriction']
+      end
+
       if attributes.key?(:'platform_connection')
         self.platform_connection = attributes[:'platform_connection']
       end
@@ -210,6 +218,7 @@ module Zernio
           permissions == o.permissions &&
           issues == o.issues &&
           recommendations == o.recommendations &&
+          messaging_restriction == o.messaging_restriction &&
           platform_connection == o.platform_connection
     end
 
@@ -222,7 +231,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, platform, username, display_name, status, token_status, permissions, issues, recommendations, platform_connection].hash
+      [account_id, platform, username, display_name, status, token_status, permissions, issues, recommendations, messaging_restriction, platform_connection].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/get_all_accounts_health200_response_accounts_inner.rb

@@ -39,6 +39,8 @@ module Zernio
 
     attr_accessor :issues
 
+    attr_accessor :messaging_restriction
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -75,7 +77,8 @@ module Zernio
         :'token_valid' => :'tokenValid',
         :'token_expires_at' => :'tokenExpiresAt',
         :'needs_reconnect' => :'needsReconnect',
-        :'issues' => :'issues'
+        :'issues' => :'issues',
+        :'messaging_restriction' => :'messagingRestriction'
       }
     end
 
@@ -103,7 +106,8 @@ module Zernio
         :'token_valid' => :'Boolean',
         :'token_expires_at' => :'Time',
         :'needs_reconnect' => :'Boolean',
-        :'issues' => :'Array<String>'
+        :'issues' => :'Array<String>',
+        :'messaging_restriction' => :'GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction'
       }
     end
 
@@ -178,6 +182,10 @@ module Zernio
           self.issues = value
         end
       end
+
+      if attributes.key?(:'messaging_restriction')
+        self.messaging_restriction = attributes[:'messaging_restriction']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -223,7 +231,8 @@ module Zernio
           token_valid == o.token_valid &&
           token_expires_at == o.token_expires_at &&
           needs_reconnect == o.needs_reconnect &&
-          issues == o.issues
+          issues == o.issues &&
+          messaging_restriction == o.messaging_restriction
     end
 
     # @see the `==` method
@@ -235,7 +244,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [account_id, platform, username, display_name, profile_id, status, can_post, can_fetch_analytics, token_valid, token_expires_at, needs_reconnect, issues].hash
+      [account_id, platform, username, display_name, profile_id, status, can_post, can_fetch_analytics, token_valid, token_expires_at, needs_reconnect, issues, messaging_restriction].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/models/{send_private_reply_to_comment400_response.rb → get_all_accounts_health200_response_accounts_inner_messaging_restriction.rb}

@@ -14,38 +14,23 @@ require 'date'
 require 'time'
 
 module Zernio
-  class SendPrivateReplyToComment400Response < ApiModelBase
-    attr_accessor :error
-
-    attr_accessor :code
-
-    class EnumAttributeValidator
-      attr_reader :datatype
-      attr_reader :allowable_values
-
-      def initialize(datatype, allowable_values)
-        @allowable_values = allowable_values.map do |value|
-          case datatype.to_s
-          when /Integer/i
-            value.to_i
-          when /Float/i
-            value.to_f
-          else
-            value
-          end
-        end
-      end
+  # Observed from Meta's own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.
+  class GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction < ApiModelBase
+    attr_accessor :subcode
 
-      def valid?(value)
-        !value || allowable_values.include?(value)
-      end
-    end
+    attr_accessor :message
+
+    attr_accessor :first_seen_at
+
+    attr_accessor :last_seen_at
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'error' => :'error',
-        :'code' => :'code'
+        :'subcode' => :'subcode',
+        :'message' => :'message',
+        :'first_seen_at' => :'firstSeenAt',
+        :'last_seen_at' => :'lastSeenAt'
       }
     end
 
@@ -62,8 +47,10 @@ module Zernio
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'error' => :'String',
-        :'code' => :'String'
+        :'subcode' => :'Integer',
+        :'message' => :'String',
+        :'first_seen_at' => :'Time',
+        :'last_seen_at' => :'Time'
       }
     end
 
@@ -77,24 +64,32 @@ module Zernio
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::SendPrivateReplyToComment400Response` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::SendPrivateReplyToComment400Response`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'error')
-        self.error = attributes[:'error']
+      if attributes.key?(:'subcode')
+        self.subcode = attributes[:'subcode']
       end
 
-      if attributes.key?(:'code')
-        self.code = attributes[:'code']
+      if attributes.key?(:'message')
+        self.message = attributes[:'message']
+      end
+
+      if attributes.key?(:'first_seen_at')
+        self.first_seen_at = attributes[:'first_seen_at']
+      end
+
+      if attributes.key?(:'last_seen_at')
+        self.last_seen_at = attributes[:'last_seen_at']
       end
     end
 
@@ -110,28 +105,18 @@ module Zernio
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      code_validator = EnumAttributeValidator.new('String', ["PLATFORM_LIMITATION"])
-      return false unless code_validator.valid?(@code)
       true
     end
 
-    # Custom attribute writer method checking allowed values (enum).
-    # @param [Object] code Object to be assigned
-    def code=(code)
-      validator = EnumAttributeValidator.new('String', ["PLATFORM_LIMITATION"])
-      unless validator.valid?(code)
-        fail ArgumentError, "invalid value for \"code\", must be one of #{validator.allowable_values}."
-      end
-      @code = code
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          error == o.error &&
-          code == o.code
+          subcode == o.subcode &&
+          message == o.message &&
+          first_seen_at == o.first_seen_at &&
+          last_seen_at == o.last_seen_at
     end
 
     # @see the `==` method
@@ -143,7 +128,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [error, code].hash
+      [subcode, message, first_seen_at, last_seen_at].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.833'
+  VERSION = '0.0.835'
 end

data/lib/zernio-sdk.rb

@@ -529,6 +529,7 @@ require 'zernio-sdk/models/get_ads_search_terms200_response_paging'
 require 'zernio-sdk/models/get_ads_timeline202_response'
 require 'zernio-sdk/models/get_all_accounts_health200_response'
 require 'zernio-sdk/models/get_all_accounts_health200_response_accounts_inner'
+require 'zernio-sdk/models/get_all_accounts_health200_response_accounts_inner_messaging_restriction'
 require 'zernio-sdk/models/get_all_accounts_health200_response_summary'
 require 'zernio-sdk/models/get_analytics200_response'
 require 'zernio-sdk/models/get_analytics400_response'
@@ -1337,7 +1338,6 @@ require 'zernio-sdk/models/send_inbox_message_request_template'
 require 'zernio-sdk/models/send_inbox_message_request_template_elements_inner'
 require 'zernio-sdk/models/send_inbox_message_request_template_elements_inner_buttons_inner'
 require 'zernio-sdk/models/send_private_reply_to_comment200_response'
-require 'zernio-sdk/models/send_private_reply_to_comment400_response'
 require 'zernio-sdk/models/send_private_reply_to_comment_request'
 require 'zernio-sdk/models/send_private_reply_to_comment_request_buttons_inner'
 require 'zernio-sdk/models/send_private_reply_to_comment_request_buttons_inner_one_of'

data/openapi.yaml

@@ -1544,7 +1544,10 @@ components:
         details:
           type: object
           additionalProperties: true
-          description: Additional structured context (e.g. field-level validation errors).
+          description: >-
+            Additional structured context (e.g. field-level validation errors), for example
+            `privateReplyConsumed` on the private-reply endpoint's 400 when the comment's
+            single reply is already spent.
     CommentAutomationAudience:
       type: object
       description: |
@@ -16986,6 +16989,14 @@ paths:
                         tokenExpiresAt: { type: string, format: date-time }
                         needsReconnect: { type: boolean }
                         issues: { type: array, items: { type: string } }
+                        messagingRestriction:
+                          type: [object, "null"]
+                          description: 'Observed from Meta''s own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.'
+                          properties:
+                            subcode: { type: integer }
+                            message: { type: string }
+                            firstSeenAt: { type: string, format: date-time }
+                            lastSeenAt: { type: string, format: date-time }
               example:
                 summary:
                   total: 5
@@ -17147,6 +17158,14 @@ paths:
                     type: array
                     items: { type: string }
                     description: Actionable recommendations to fix issues
+                  messagingRestriction:
+                    type: [object, "null"]
+                    description: 'Observed from Meta''s own error subcodes on our own sends (2534122, 1893063, 2534029), not a live probe. Set on the first refused send and cleared when a later send succeeds, so it lags reality by one send in each direction.'
+                    properties:
+                      subcode: { type: integer }
+                      message: { type: string }
+                      firstSeenAt: { type: string, format: date-time }
+                      lastSeenAt: { type: string, format: date-time }
                   platformConnection:
                     type: object
                     description: 'WhatsApp accounts only. Live probe of the Meta link behind the channel, performed at request time (the same read as GET /v1/whatsapp/number-info).'
@@ -29708,7 +29727,9 @@ paths:
         cards and attachments to commenters who do not follow the account (Meta code 2, subcode
         1545133, returned here as a non-retryable 400 that says so), and the failed call still
         consumes the comment's single private reply. To reach non-followers send plain text and
-        add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive.
+        add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. When
+        the comment's single private reply is spent (by this call or an earlier one) the 400
+        carries `details.privateReplyConsumed: true`; never retry it.
       tags: [Comments]
       security: [{ bearerAuth: [] }]
       parameters:
@@ -29842,31 +29863,54 @@ paths:
           content:
             application/json:
               schema:
-                type: object
-                properties:
-                  error:
-                    type: string
-                  code:
-                    type: string
-                    enum: [PLATFORM_LIMITATION]
+                $ref: '#/components/schemas/ErrorResponse'
               examples:
                 platformNotSupported:
                   summary: Platform not supported
                   value:
                     error: "Private replies to comments are only supported on Instagram and Facebook."
-                    code: "PLATFORM_LIMITATION"
+                    type: "invalid_request_error"
+                    code: "invalid_field_value"
+                    param: "accountId"
+                followGated:
+                  summary: "Media refused, commenter does not follow the account (reply consumed)"
+                  value:
+                    error: "Instagram refused this private reply because it carries a card, buttons or an attachment and the commenter does not follow this account. Meta delivers only plain text to non-followers. This attempt consumed the comment's single private reply, so do not retry it; send a text-only private reply to reach non-followers."
+                    type: "platform_error"
+                    code: "platform_api_error"
+                    platform: "instagram"
+                    platformError:
+                      code: 2
+                      error_subcode: 1545133
+                      is_transient: false
+                      message: "Service temporarily unavailable"
+                      error_user_title: "Your message can't be delivered"
+                      error_user_msg: "You can't send media to Jejum de Daniel unless they follow you."
+                    details:
+                      privateReplyConsumed: true
                 alreadyReplied:
-                  summary: Already sent a private reply
+                  summary: "Already sent a private reply (reply consumed, Meta subcode 2534023)"
                   value:
-                    error: "A private reply has already been sent to this comment, or the 7-day reply window has expired. Only one private reply per comment is allowed within 7 days."
+                    error: "A private reply has already been sent to this comment. Instagram only allows one private reply per comment."
+                    type: "platform_error"
+                    code: "platform_api_error"
+                    platform: "instagram"
+                    details:
+                      privateReplyConsumed: true
                 commentTooOld:
                   summary: Comment older than 7 days
                   value:
-                    error: "The comment is older than 7 days. Private replies can only be sent within 7 days of the comment being posted."
+                    error: "The comment is older than 7 days. Instagram only allows private replies within 7 days of the comment being posted."
+                    type: "platform_error"
+                    code: "platform_api_error"
+                    platform: "instagram"
                 missingMessage:
                   summary: Missing message
                   value:
                     error: "message is required and must be a non-empty string"
+                    type: "invalid_request_error"
+                    code: "missing_required_field"
+                    param: "message"
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Inbox addon required

data/spec/api/comments_api_spec.rb

@@ -154,7 +154,7 @@ describe 'CommentsApi' do
 
   # unit tests for send_private_reply_to_comment
   # Send private reply
-  # Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. 
+  # Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: `quickReplies` (chips above the keyboard, max 13) or `buttons` (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Chips do not render in the Instagram Message Requests folder. Since late August 2026 Instagram refuses buttons, cards and attachments to commenters who do not follow the account (Meta code 2, subcode 1545133, returned here as a non-retryable 400 that says so), and the failed call still consumes the comment's single private reply. To reach non-followers send plain text and add buttons once they reply. `quickReplies` and `buttons` are mutually exclusive. When the comment's single private reply is spent (by this call or an earlier one) the 400 carries `details.privateReplyConsumed: true`; never retry it. 
   # @param post_id The media/post ID (Instagram media ID or Facebook post ID)
   # @param comment_id The comment ID to send a private reply to
   # @param send_private_reply_to_comment_request 

data/spec/models/get_account_health200_response_spec.rb

@@ -85,6 +85,12 @@ describe Zernio::GetAccountHealth200Response do
     end
   end
 
+  describe 'test attribute "messaging_restriction"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "platform_connection"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/spec/models/{send_private_reply_to_comment400_response_spec.rb → get_all_accounts_health200_response_accounts_inner_messaging_restriction_spec.rb}

@@ -14,32 +14,40 @@ require 'spec_helper'
 require 'json'
 require 'date'
 
-# Unit tests for Zernio::SendPrivateReplyToComment400Response
+# Unit tests for Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction
 # Automatically generated by openapi-generator (https://openapi-generator.tech)
 # Please update as you see appropriate
-describe Zernio::SendPrivateReplyToComment400Response do
-  #let(:instance) { Zernio::SendPrivateReplyToComment400Response.new }
+describe Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction do
+  #let(:instance) { Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction.new }
 
-  describe 'test an instance of SendPrivateReplyToComment400Response' do
-    it 'should create an instance of SendPrivateReplyToComment400Response' do
+  describe 'test an instance of GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction' do
+    it 'should create an instance of GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction' do
       # uncomment below to test the instance creation
-      #expect(instance).to be_instance_of(Zernio::SendPrivateReplyToComment400Response)
+      #expect(instance).to be_instance_of(Zernio::GetAllAccountsHealth200ResponseAccountsInnerMessagingRestriction)
     end
   end
 
-  describe 'test attribute "error"' do
+  describe 'test attribute "subcode"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  describe 'test attribute "code"' do
+  describe 'test attribute "message"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "first_seen_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "last_seen_at"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["PLATFORM_LIMITATION"])
-      # validator.allowable_values.each do |value|
-      #   expect { instance.code = value }.not_to raise_error
-      # end
     end
   end
 

data/spec/models/get_all_accounts_health200_response_accounts_inner_spec.rb

@@ -103,4 +103,10 @@ describe Zernio::GetAllAccountsHealth200ResponseAccountsInner do
     end
   end
 
+  describe 'test attribute "messaging_restriction"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end