moderation_api 2.34.0 → 2.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6c81ee2a9da518fa7c2d46dd6de06482739a80d3c7bc72e415c459e049b5118
-  data.tar.gz: 30591937048d8e2662f1b4106fa0a1e1478220759995543efd8305a24e31fbc0
+  metadata.gz: 0b2f092ece0ba8250396eff6b7d47dab8a667bc7989f980b1233a04db59ef83a
+  data.tar.gz: 9f1428ab035b3565d0ede0d83ad78bcbc4d29ec89682df227299119c4f16db0a
 SHA512:
-  metadata.gz: f22f683cf8f5a19e6f672ea2823869a529aae0a159ad30a7eda1e47fb1ca5f2714d1bab28b21b05af334ad8fa645797cf9efbcddf709bfa5f18fb86e13f5140e
-  data.tar.gz: 0e6cd98b619b02bbdcfa571fcae9f9903c8062f95554f1673649c5c8341190c3d321a15fcaffcde5eeb7b1c5fbd87f35f7cfe00e8dd4df04d0db1b4df6786c93
+  metadata.gz: aee81fbb058666bc8913eba73621a8d2e7a105af8d097939644238221a31348c4f8659ca4c701777be6e012244399b1632b545ac34eadc43a5e686a739cf4430
+  data.tar.gz: d0403bd95eb8461ddb1c06fd7e1048a0971efceba3841228666a881f5c66d2bcc8096360812f90a103ae74f1ac5ccb5dfebfd75080cf27a152415a1f964b8f79

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2.36.0 (2026-08-24)
+
+Full Changelog: [v2.35.0...v2.36.0](https://github.com/moderation-api/sdk-ruby/compare/v2.35.0...v2.36.0)
+
+### Features
+
+* **api:** api update ([7710268](https://github.com/moderation-api/sdk-ruby/commit/7710268d6a85d13d3b4cb3cef7cee8c442f473c7))
+
+## 2.35.0 (2026-08-21)
+
+Full Changelog: [v2.34.0...v2.35.0](https://github.com/moderation-api/sdk-ruby/compare/v2.34.0...v2.35.0)
+
+### Features
+
+* **api:** api update ([ce30b48](https://github.com/moderation-api/sdk-ruby/commit/ce30b48c33ec082b8143b3af082d07de83c44a3d))
+
 ## 2.34.0 (2026-08-20)
 
 Full Changelog: [v2.33.0...v2.34.0](https://github.com/moderation-api/sdk-ruby/compare/v2.33.0...v2.34.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "moderation_api", "~> 2.34.0"
+gem "moderation_api", "~> 2.36.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/moderation_api/models/content_submit_response.rb

@@ -11,6 +11,16 @@ module ModerationAPI
       #   @return [ModerationAPI::Models::ContentSubmitResponse::Author, nil]
       required :author, -> { ModerationAPI::Models::ContentSubmitResponse::Author }, nil?: true
 
+      # @!attribute casebook
+      #   What your casebook — the record of your past moderation decisions — found for
+      #   this content, or null when it had nothing close enough to say, when the matching
+      #   cases disagreed, or when casebook lookups are not switched on for this channel.
+      #   Reports what the casebook found; whether it decided the outcome is shown in
+      #   `recommendation`, where a higher-priority rule may have settled the item first.
+      #
+      #   @return [ModerationAPI::Models::ContentSubmitResponse::Casebook, nil]
+      required :casebook, -> { ModerationAPI::Models::ContentSubmitResponse::Casebook }, nil?: true
+
       # @!attribute content
       #   Potentially modified content.
       #
@@ -56,12 +66,14 @@ module ModerationAPI
       optional :errors,
                -> { ModerationAPI::Internal::Type::ArrayOf[ModerationAPI::Models::ContentSubmitResponse::Error] }
 
-      # @!method initialize(author:, content:, evaluation:, insights:, meta:, policies:, recommendation:, errors: nil)
+      # @!method initialize(author:, casebook:, content:, evaluation:, insights:, meta:, policies:, recommendation:, errors: nil)
       #   Some parameter documentations has been truncated, see
       #   {ModerationAPI::Models::ContentSubmitResponse} for more details.
       #
       #   @param author [ModerationAPI::Models::ContentSubmitResponse::Author, nil] The author of the content if your account has authors enabled. Requires you to s
       #
+      #   @param casebook [ModerationAPI::Models::ContentSubmitResponse::Casebook, nil] What your casebook — the record of your past moderation decisions — found for th
+      #
       #   @param content [ModerationAPI::Models::ContentSubmitResponse::Content] Potentially modified content.
       #
       #   @param evaluation [ModerationAPI::Models::ContentSubmitResponse::Evaluation] The evaluation of the content after running the channel policies.
@@ -178,6 +190,109 @@ module ModerationAPI
         end
       end
 
+      # @see ModerationAPI::Models::ContentSubmitResponse#casebook
+      class Casebook < ModerationAPI::Internal::Type::BaseModel
+        # @!attribute agreement
+        #   How unanimous the matching cases are, from 0 to 1: the share of them that
+        #   decided this way, ignoring how many there are. Always at least 0.8 when a ruling
+        #   is returned — below that the casebook reports a disagreement instead of picking
+        #   a side — so it tells you how clean the consensus was, and is not a threshold to
+        #   re-apply yourself.
+        #
+        #   @return [Float]
+        required :agreement, Float
+
+        # @!attribute case_count
+        #   How many of your past cases backed this ruling.
+        #
+        #   @return [Float]
+        required :case_count, Float
+
+        # @!attribute confidence
+        #   How strongly the casebook holds this ruling, from 0 to 1: the agreement scaled
+        #   by how much evidence backs it, so a handful of close, recent cases outweighs one
+        #   distant one. Older cases count for less, halving in weight roughly every 180
+        #   days. This is the number to use in rules when you want a strength condition.
+        #
+        #   @return [Float]
+        required :confidence, Float
+
+        # @!attribute similarity
+        #   How close the nearest matching case is, from 0 to 1. 1 means the content is
+        #   identical to something you have already decided.
+        #
+        #   @return [Float]
+        required :similarity, Float
+
+        # @!attribute topic
+        #   The topic the closest matching case is filed under, or null when it has not been
+        #   grouped into one yet.
+        #
+        #   @return [ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic, nil]
+        required :topic, -> { ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic }, nil?: true
+
+        # @!attribute verdict
+        #   The ruling your past decisions point to for this content.
+        #
+        #   @return [Symbol, ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict]
+        required :verdict, enum: -> { ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict }
+
+        # @!method initialize(agreement:, case_count:, confidence:, similarity:, topic:, verdict:)
+        #   Some parameter documentations has been truncated, see
+        #   {ModerationAPI::Models::ContentSubmitResponse::Casebook} for more details.
+        #
+        #   What your casebook — the record of your past moderation decisions — found for
+        #   this content, or null when it had nothing close enough to say, when the matching
+        #   cases disagreed, or when casebook lookups are not switched on for this channel.
+        #   Reports what the casebook found; whether it decided the outcome is shown in
+        #   `recommendation`, where a higher-priority rule may have settled the item first.
+        #
+        #   @param agreement [Float] How unanimous the matching cases are, from 0 to 1: the share of them that decide
+        #
+        #   @param case_count [Float] How many of your past cases backed this ruling.
+        #
+        #   @param confidence [Float] How strongly the casebook holds this ruling, from 0 to 1: the agreement scaled b
+        #
+        #   @param similarity [Float] How close the nearest matching case is, from 0 to 1. 1 means the content is iden
+        #
+        #   @param topic [ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic, nil] The topic the closest matching case is filed under, or null when it has not been
+        #
+        #   @param verdict [Symbol, ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict] The ruling your past decisions point to for this content.
+
+        # @see ModerationAPI::Models::ContentSubmitResponse::Casebook#topic
+        class Topic < ModerationAPI::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute label
+          #
+          #   @return [String]
+          required :label, String
+
+          # @!method initialize(id:, label:)
+          #   The topic the closest matching case is filed under, or null when it has not been
+          #   grouped into one yet.
+          #
+          #   @param id [String]
+          #   @param label [String]
+        end
+
+        # The ruling your past decisions point to for this content.
+        #
+        # @see ModerationAPI::Models::ContentSubmitResponse::Casebook#verdict
+        module Verdict
+          extend ModerationAPI::Internal::Type::Enum
+
+          ALLOW = :allow
+          REJECT = :reject
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # @see ModerationAPI::Models::ContentSubmitResponse#content
       class Content < ModerationAPI::Internal::Type::BaseModel
         # @!attribute id
@@ -935,6 +1050,8 @@ module ModerationAPI
 
           variant const: -> { ModerationAPI::Models::ContentSubmitResponse::Recommendation::ReasonCode::CLIENT_OVERRIDE }
 
+          variant const: -> { ModerationAPI::Models::ContentSubmitResponse::Recommendation::ReasonCode::CASEBOOK_MATCH }
+
           variant String
 
           # @!method self.variants
@@ -956,6 +1073,7 @@ module ModerationAPI
           RULE_DEFAULT = :rule_default
           RULE_FALLBACK = :rule_fallback
           CLIENT_OVERRIDE = :client_override
+          CASEBOOK_MATCH = :casebook_match
 
           # @!endgroup
         end

data/lib/moderation_api/models/queue_retrieve_response.rb

@@ -82,6 +82,13 @@ module ModerationAPI
           #   @return [String, nil]
           optional :before_date, String, api_name: :beforeDate
 
+          # @!attribute casebook_handled
+          #
+          #   @return [Symbol, ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled, nil]
+          optional :casebook_handled,
+                   enum: -> { ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled },
+                   api_name: :casebookHandled
+
           # @!attribute check_status
           #
           #   @return [Symbol, ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CheckStatus, nil]
@@ -193,11 +200,12 @@ module ModerationAPI
                    enum: -> { ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::WithinUnit },
                    api_name: :withinUnit
 
-          # @!method initialize(after_date: nil, author_id: nil, author_trust_levels: nil, before_date: nil, check_status: nil, clear_date_window: nil, content_id: nil, content_types: nil, conversation_ids: nil, filtered_action_ids: nil, filtered_channel_ids: nil, filter_labels: nil, is_flagged: nil, labels: nil, languages: nil, max_severity: nil, media_types: nil, min_severity: nil, recommendation_actions: nil, search: nil, within: nil, within_unit: nil)
+          # @!method initialize(after_date: nil, author_id: nil, author_trust_levels: nil, before_date: nil, casebook_handled: nil, check_status: nil, clear_date_window: nil, content_id: nil, content_types: nil, conversation_ids: nil, filtered_action_ids: nil, filtered_channel_ids: nil, filter_labels: nil, is_flagged: nil, labels: nil, languages: nil, max_severity: nil, media_types: nil, min_severity: nil, recommendation_actions: nil, search: nil, within: nil, within_unit: nil)
           #   @param after_date [String]
           #   @param author_id [String]
           #   @param author_trust_levels [Array<Integer>]
           #   @param before_date [String]
+          #   @param casebook_handled [Symbol, ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled]
           #   @param check_status [Symbol, ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CheckStatus, nil]
           #   @param clear_date_window [Boolean]
           #   @param content_id [String]
@@ -217,6 +225,18 @@ module ModerationAPI
           #   @param within [Float]
           #   @param within_unit [Symbol, ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::WithinUnit]
 
+          # @see ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter#casebook_handled
+          module CasebookHandled
+            extend ModerationAPI::Internal::Type::Enum
+
+            ALL = :ALL
+            HANDLED = :HANDLED
+            WOULD_HAVE_HANDLED = :WOULD_HAVE_HANDLED
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter#check_status
           module CheckStatus
             extend ModerationAPI::Internal::Type::Enum

data/lib/moderation_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ModerationAPI
-  VERSION = "2.34.0"
+  VERSION = "2.36.0"
 end

data/rbi/moderation_api/models/content_submit_response.rbi

@@ -28,6 +28,28 @@ module ModerationAPI
       end
       attr_writer :author
 
+      # What your casebook — the record of your past moderation decisions — found for
+      # this content, or null when it had nothing close enough to say, when the matching
+      # cases disagreed, or when casebook lookups are not switched on for this channel.
+      # Reports what the casebook found; whether it decided the outcome is shown in
+      # `recommendation`, where a higher-priority rule may have settled the item first.
+      sig do
+        returns(
+          T.nilable(ModerationAPI::Models::ContentSubmitResponse::Casebook)
+        )
+      end
+      attr_reader :casebook
+
+      sig do
+        params(
+          casebook:
+            T.nilable(
+              ModerationAPI::Models::ContentSubmitResponse::Casebook::OrHash
+            )
+        ).void
+      end
+      attr_writer :casebook
+
       # Potentially modified content.
       sig { returns(ModerationAPI::Models::ContentSubmitResponse::Content) }
       attr_reader :content
@@ -122,6 +144,10 @@ module ModerationAPI
             T.nilable(
               ModerationAPI::Models::ContentSubmitResponse::Author::OrHash
             ),
+          casebook:
+            T.nilable(
+              ModerationAPI::Models::ContentSubmitResponse::Casebook::OrHash
+            ),
           content:
             ModerationAPI::Models::ContentSubmitResponse::Content::OrHash,
           evaluation:
@@ -153,6 +179,12 @@ module ModerationAPI
         # The author of the content if your account has authors enabled. Requires you to
         # send authorId when submitting content.
         author:,
+        # What your casebook — the record of your past moderation decisions — found for
+        # this content, or null when it had nothing close enough to say, when the matching
+        # cases disagreed, or when casebook lookups are not switched on for this channel.
+        # Reports what the casebook found; whether it decided the outcome is shown in
+        # `recommendation`, where a higher-priority rule may have settled the item first.
+        casebook:,
         # Potentially modified content.
         content:,
         # The evaluation of the content after running the channel policies.
@@ -175,6 +207,8 @@ module ModerationAPI
           {
             author:
               T.nilable(ModerationAPI::Models::ContentSubmitResponse::Author),
+            casebook:
+              T.nilable(ModerationAPI::Models::ContentSubmitResponse::Casebook),
             content: ModerationAPI::Models::ContentSubmitResponse::Content,
             evaluation:
               ModerationAPI::Models::ContentSubmitResponse::Evaluation,
@@ -419,6 +453,193 @@ module ModerationAPI
         end
       end
 
+      class Casebook < ModerationAPI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ModerationAPI::Models::ContentSubmitResponse::Casebook,
+              ModerationAPI::Internal::AnyHash
+            )
+          end
+
+        # How unanimous the matching cases are, from 0 to 1: the share of them that
+        # decided this way, ignoring how many there are. Always at least 0.8 when a ruling
+        # is returned — below that the casebook reports a disagreement instead of picking
+        # a side — so it tells you how clean the consensus was, and is not a threshold to
+        # re-apply yourself.
+        sig { returns(Float) }
+        attr_accessor :agreement
+
+        # How many of your past cases backed this ruling.
+        sig { returns(Float) }
+        attr_accessor :case_count
+
+        # How strongly the casebook holds this ruling, from 0 to 1: the agreement scaled
+        # by how much evidence backs it, so a handful of close, recent cases outweighs one
+        # distant one. Older cases count for less, halving in weight roughly every 180
+        # days. This is the number to use in rules when you want a strength condition.
+        sig { returns(Float) }
+        attr_accessor :confidence
+
+        # How close the nearest matching case is, from 0 to 1. 1 means the content is
+        # identical to something you have already decided.
+        sig { returns(Float) }
+        attr_accessor :similarity
+
+        # The topic the closest matching case is filed under, or null when it has not been
+        # grouped into one yet.
+        sig do
+          returns(
+            T.nilable(
+              ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic
+            )
+          )
+        end
+        attr_reader :topic
+
+        sig do
+          params(
+            topic:
+              T.nilable(
+                ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic::OrHash
+              )
+          ).void
+        end
+        attr_writer :topic
+
+        # The ruling your past decisions point to for this content.
+        sig do
+          returns(
+            ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict::TaggedSymbol
+          )
+        end
+        attr_accessor :verdict
+
+        # What your casebook — the record of your past moderation decisions — found for
+        # this content, or null when it had nothing close enough to say, when the matching
+        # cases disagreed, or when casebook lookups are not switched on for this channel.
+        # Reports what the casebook found; whether it decided the outcome is shown in
+        # `recommendation`, where a higher-priority rule may have settled the item first.
+        sig do
+          params(
+            agreement: Float,
+            case_count: Float,
+            confidence: Float,
+            similarity: Float,
+            topic:
+              T.nilable(
+                ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic::OrHash
+              ),
+            verdict:
+              ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # How unanimous the matching cases are, from 0 to 1: the share of them that
+          # decided this way, ignoring how many there are. Always at least 0.8 when a ruling
+          # is returned — below that the casebook reports a disagreement instead of picking
+          # a side — so it tells you how clean the consensus was, and is not a threshold to
+          # re-apply yourself.
+          agreement:,
+          # How many of your past cases backed this ruling.
+          case_count:,
+          # How strongly the casebook holds this ruling, from 0 to 1: the agreement scaled
+          # by how much evidence backs it, so a handful of close, recent cases outweighs one
+          # distant one. Older cases count for less, halving in weight roughly every 180
+          # days. This is the number to use in rules when you want a strength condition.
+          confidence:,
+          # How close the nearest matching case is, from 0 to 1. 1 means the content is
+          # identical to something you have already decided.
+          similarity:,
+          # The topic the closest matching case is filed under, or null when it has not been
+          # grouped into one yet.
+          topic:,
+          # The ruling your past decisions point to for this content.
+          verdict:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              agreement: Float,
+              case_count: Float,
+              confidence: Float,
+              similarity: Float,
+              topic:
+                T.nilable(
+                  ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic
+                ),
+              verdict:
+                ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Topic < ModerationAPI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic,
+                ModerationAPI::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          sig { returns(String) }
+          attr_accessor :label
+
+          # The topic the closest matching case is filed under, or null when it has not been
+          # grouped into one yet.
+          sig { params(id: String, label: String).returns(T.attached_class) }
+          def self.new(id:, label:)
+          end
+
+          sig { override.returns({ id: String, label: String }) }
+          def to_hash
+          end
+        end
+
+        # The ruling your past decisions point to for this content.
+        module Verdict
+          extend ModerationAPI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          ALLOW =
+            T.let(
+              :allow,
+              ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict::TaggedSymbol
+            )
+          REJECT =
+            T.let(
+              :reject,
+              ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ModerationAPI::Models::ContentSubmitResponse::Casebook::Verdict::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       class Content < ModerationAPI::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -1828,6 +2049,11 @@ module ModerationAPI
               :client_override,
               ModerationAPI::Models::ContentSubmitResponse::Recommendation::ReasonCode::TaggedSymbol
             )
+          CASEBOOK_MATCH =
+            T.let(
+              :casebook_match,
+              ModerationAPI::Models::ContentSubmitResponse::Recommendation::ReasonCode::TaggedSymbol
+            )
         end
 
         class MatchedRule < ModerationAPI::Internal::Type::BaseModel

data/rbi/moderation_api/models/queue_retrieve_response.rbi

@@ -150,6 +150,23 @@ module ModerationAPI
           sig { params(before_date: String).void }
           attr_writer :before_date
 
+          sig do
+            returns(
+              T.nilable(
+                ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :casebook_handled
+
+          sig do
+            params(
+              casebook_handled:
+                ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::OrSymbol
+            ).void
+          end
+          attr_writer :casebook_handled
+
           sig do
             returns(
               T.nilable(
@@ -349,6 +366,8 @@ module ModerationAPI
               author_id: String,
               author_trust_levels: T::Array[Integer],
               before_date: String,
+              casebook_handled:
+                ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::OrSymbol,
               check_status:
                 T.nilable(
                   ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CheckStatus::OrSymbol
@@ -391,6 +410,7 @@ module ModerationAPI
             author_id: nil,
             author_trust_levels: nil,
             before_date: nil,
+            casebook_handled: nil,
             check_status: nil,
             clear_date_window: nil,
             content_id: nil,
@@ -419,6 +439,8 @@ module ModerationAPI
                 author_id: String,
                 author_trust_levels: T::Array[Integer],
                 before_date: String,
+                casebook_handled:
+                  ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::TaggedSymbol,
                 check_status:
                   T.nilable(
                     ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CheckStatus::TaggedSymbol
@@ -460,6 +482,45 @@ module ModerationAPI
           def to_hash
           end
 
+          module CasebookHandled
+            extend ModerationAPI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ALL =
+              T.let(
+                :ALL,
+                ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::TaggedSymbol
+              )
+            HANDLED =
+              T.let(
+                :HANDLED,
+                ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::TaggedSymbol
+              )
+            WOULD_HAVE_HANDLED =
+              T.let(
+                :WOULD_HAVE_HANDLED,
+                ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::CasebookHandled::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
           module CheckStatus
             extend ModerationAPI::Internal::Type::Enum
 

data/sig/moderation_api/models/content_submit_response.rbs

@@ -3,6 +3,7 @@ module ModerationAPI
     type content_submit_response =
       {
         author: ModerationAPI::Models::ContentSubmitResponse::Author?,
+        casebook: ModerationAPI::Models::ContentSubmitResponse::Casebook?,
         content: ModerationAPI::Models::ContentSubmitResponse::Content,
         evaluation: ModerationAPI::Models::ContentSubmitResponse::Evaluation,
         insights: ::Array[ModerationAPI::Models::ContentSubmitResponse::insight],
@@ -15,6 +16,8 @@ module ModerationAPI
     class ContentSubmitResponse < ModerationAPI::Internal::Type::BaseModel
       attr_accessor author: ModerationAPI::Models::ContentSubmitResponse::Author?
 
+      attr_accessor casebook: ModerationAPI::Models::ContentSubmitResponse::Casebook?
+
       attr_accessor content: ModerationAPI::Models::ContentSubmitResponse::Content
 
       attr_accessor evaluation: ModerationAPI::Models::ContentSubmitResponse::Evaluation
@@ -35,6 +38,7 @@ module ModerationAPI
 
       def initialize: (
         author: ModerationAPI::Models::ContentSubmitResponse::Author?,
+        casebook: ModerationAPI::Models::ContentSubmitResponse::Casebook?,
         content: ModerationAPI::Models::ContentSubmitResponse::Content,
         evaluation: ModerationAPI::Models::ContentSubmitResponse::Evaluation,
         insights: ::Array[ModerationAPI::Models::ContentSubmitResponse::insight],
@@ -46,6 +50,7 @@ module ModerationAPI
 
       def to_hash: -> {
         author: ModerationAPI::Models::ContentSubmitResponse::Author?,
+        casebook: ModerationAPI::Models::ContentSubmitResponse::Casebook?,
         content: ModerationAPI::Models::ContentSubmitResponse::Content,
         evaluation: ModerationAPI::Models::ContentSubmitResponse::Evaluation,
         insights: ::Array[ModerationAPI::Models::ContentSubmitResponse::insight],
@@ -128,6 +133,71 @@ module ModerationAPI
         end
       end
 
+      type casebook =
+        {
+          agreement: Float,
+          case_count: Float,
+          confidence: Float,
+          similarity: Float,
+          topic: ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic?,
+          verdict: ModerationAPI::Models::ContentSubmitResponse::Casebook::verdict
+        }
+
+      class Casebook < ModerationAPI::Internal::Type::BaseModel
+        attr_accessor agreement: Float
+
+        attr_accessor case_count: Float
+
+        attr_accessor confidence: Float
+
+        attr_accessor similarity: Float
+
+        attr_accessor topic: ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic?
+
+        attr_accessor verdict: ModerationAPI::Models::ContentSubmitResponse::Casebook::verdict
+
+        def initialize: (
+          agreement: Float,
+          case_count: Float,
+          confidence: Float,
+          similarity: Float,
+          topic: ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic?,
+          verdict: ModerationAPI::Models::ContentSubmitResponse::Casebook::verdict
+        ) -> void
+
+        def to_hash: -> {
+          agreement: Float,
+          case_count: Float,
+          confidence: Float,
+          similarity: Float,
+          topic: ModerationAPI::Models::ContentSubmitResponse::Casebook::Topic?,
+          verdict: ModerationAPI::Models::ContentSubmitResponse::Casebook::verdict
+        }
+
+        type topic = { id: String, label: String }
+
+        class Topic < ModerationAPI::Internal::Type::BaseModel
+          attr_accessor id: String
+
+          attr_accessor label: String
+
+          def initialize: (id: String, label: String) -> void
+
+          def to_hash: -> { id: String, label: String }
+        end
+
+        type verdict = :allow | :reject
+
+        module Verdict
+          extend ModerationAPI::Internal::Type::Enum
+
+          ALLOW: :allow
+          REJECT: :reject
+
+          def self?.values: -> ::Array[ModerationAPI::Models::ContentSubmitResponse::Casebook::verdict]
+        end
+      end
+
       type content =
         {
           id: String,
@@ -758,6 +828,7 @@ module ModerationAPI
           | :rule_default
           | :rule_fallback
           | :client_override
+          | :casebook_match
           | String
 
         module ReasonCode
@@ -775,6 +846,7 @@ module ModerationAPI
           RULE_DEFAULT: :rule_default
           RULE_FALLBACK: :rule_fallback
           CLIENT_OVERRIDE: :client_override
+          CASEBOOK_MATCH: :casebook_match
         end
 
         type matched_rule = { key: String, name: String }

data/sig/moderation_api/models/queue_retrieve_response.rbs

@@ -66,6 +66,7 @@ module ModerationAPI
             author_id: String,
             author_trust_levels: ::Array[Integer],
             before_date: String,
+            casebook_handled: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::casebook_handled,
             check_status: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::check_status?,
             clear_date_window: bool,
             content_id: String,
@@ -103,6 +104,12 @@ module ModerationAPI
 
           def before_date=: (String) -> String
 
+          attr_reader casebook_handled: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::casebook_handled?
+
+          def casebook_handled=: (
+            ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::casebook_handled
+          ) -> ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::casebook_handled
+
           attr_accessor check_status: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::check_status?
 
           attr_reader clear_date_window: bool?
@@ -190,6 +197,7 @@ module ModerationAPI
             ?author_id: String,
             ?author_trust_levels: ::Array[Integer],
             ?before_date: String,
+            ?casebook_handled: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::casebook_handled,
             ?check_status: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::check_status?,
             ?clear_date_window: bool,
             ?content_id: String,
@@ -215,6 +223,7 @@ module ModerationAPI
             author_id: String,
             author_trust_levels: ::Array[Integer],
             before_date: String,
+            casebook_handled: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::casebook_handled,
             check_status: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::check_status?,
             clear_date_window: bool,
             content_id: String,
@@ -235,6 +244,18 @@ module ModerationAPI
             within_unit: ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::within_unit
           }
 
+          type casebook_handled = :ALL | :HANDLED | :WOULD_HAVE_HANDLED
+
+          module CasebookHandled
+            extend ModerationAPI::Internal::Type::Enum
+
+            ALL: :ALL
+            HANDLED: :HANDLED
+            WOULD_HAVE_HANDLED: :WOULD_HAVE_HANDLED
+
+            def self?.values: -> ::Array[ModerationAPI::Models::QueueRetrieveResponse::Queue::Filter::casebook_handled]
+          end
+
           type check_status = :all | :checked | :unchecked
 
           module CheckStatus

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moderation_api
 version: !ruby/object:Gem::Version
-  version: 2.34.0
+  version: 2.36.0
 platform: ruby
 authors:
 - Moderation API
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-20 00:00:00.000000000 Z
+date: 2026-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi