moderation_api 2.20.0 → 2.22.0

data/rbi/moderation_api/models/webhook_event.rbi

@@ -4487,6 +4487,26 @@ module ModerationAPI
               sig { returns(T.nilable(String)) }
               attr_accessor :channel_key
 
+              # A recommendation from your own client-side flagging.
+              sig do
+                returns(
+                  T.nilable(
+                    ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction
+                  )
+                )
+              end
+              attr_reader :client_action
+
+              sig do
+                params(
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::OrHash
+                    )
+                ).void
+              end
+              attr_writer :client_action
+
               # The original content payload
               sig do
                 returns(
@@ -4509,6 +4529,11 @@ module ModerationAPI
               sig { returns(T.nilable(T::Boolean)) }
               attr_accessor :flagged
 
+              # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              # when no fields were flagged or the content is not an object.
+              sig { returns(T::Array[String]) }
+              attr_accessor :flagged_fields
+
               # Moderation labels applied to the content
               sig do
                 returns(
@@ -4550,6 +4575,10 @@ module ModerationAPI
                   id: String,
                   author_id: T.nilable(String),
                   channel_key: T.nilable(String),
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::OrHash
+                    ),
                   content:
                     T.any(
                       ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Text::OrHash,
@@ -4560,6 +4589,7 @@ module ModerationAPI
                     ),
                   conversation_id: T.nilable(String),
                   flagged: T.nilable(T::Boolean),
+                  flagged_fields: T::Array[String],
                   labels:
                     T.nilable(
                       T::Array[
@@ -4583,12 +4613,17 @@ module ModerationAPI
                 # The channel the content was submitted to, identified by your customer-defined
                 # channel key.
                 channel_key:,
+                # A recommendation from your own client-side flagging.
+                client_action:,
                 # The original content payload
                 content:,
                 # Conversation grouping ID, if any
                 conversation_id:,
                 # Whether the content was flagged by moderation
                 flagged:,
+                # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+                # when no fields were flagged or the content is not an object.
+                flagged_fields:,
                 # Moderation labels applied to the content
                 labels:,
                 # Detected ISO language code, if available
@@ -4610,6 +4645,10 @@ module ModerationAPI
                     id: String,
                     author_id: T.nilable(String),
                     channel_key: T.nilable(String),
+                    client_action:
+                      T.nilable(
+                        ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction
+                      ),
                     content:
                       T.any(
                         ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::Content::Text,
@@ -4620,6 +4659,7 @@ module ModerationAPI
                       ),
                     conversation_id: T.nilable(String),
                     flagged: T.nilable(T::Boolean),
+                    flagged_fields: T::Array[String],
                     labels:
                       T.nilable(
                         T::Array[
@@ -4639,6 +4679,172 @@ module ModerationAPI
               def to_hash
               end
 
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction,
+                      ModerationAPI::Internal::AnyHash
+                    )
+                  end
+
+                # Your recommendation for the content: allow, review, or reject.
+                sig do
+                  returns(
+                    ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action::OrSymbol
+                  )
+                end
+                attr_accessor :action
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                sig do
+                  returns(
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :behavior
+
+                sig do
+                  params(
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                  ).void
+                end
+                attr_writer :behavior
+
+                # A human-readable explanation for your recommendation.
+                sig { returns(T.nilable(String)) }
+                attr_reader :reason
+
+                sig { params(reason: String).void }
+                attr_writer :reason
+
+                # Where your recommendation came from, e.g. "banned-ip".
+                sig { returns(T.nilable(String)) }
+                attr_reader :source
+
+                sig { params(source: String).void }
+                attr_writer :source
+
+                # A recommendation from your own client-side flagging.
+                sig do
+                  params(
+                    action:
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action::OrSymbol,
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                    reason: String,
+                    source: String
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # Your recommendation for the content: allow, review, or reject.
+                  action:,
+                  # How your recommendation combines with ours. Defaults to 'escalate', which only
+                  # applies it when stricter than ours; 'override' replaces ours outright.
+                  behavior: nil,
+                  # A human-readable explanation for your recommendation.
+                  reason: nil,
+                  # Where your recommendation came from, e.g. "banned-ip".
+                  source: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      action:
+                        ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action::OrSymbol,
+                      behavior:
+                        ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                      reason: String,
+                      source: String
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # Your recommendation for the content: allow, review, or reject.
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  REVIEW =
+                    T.let(
+                      :review,
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  ALLOW =
+                    T.let(
+                      :allow,
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  REJECT =
+                    T.let(
+                      :reject,
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  OVERRIDE =
+                    T.let(
+                      :override,
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+                  ESCALATE =
+                    T.let(
+                      :escalate,
+                      ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemResolved::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+
               # The original content payload
               module Content
                 extend ModerationAPI::Internal::Type::Union
@@ -6759,6 +6965,26 @@ module ModerationAPI
               sig { returns(T.nilable(String)) }
               attr_accessor :channel_key
 
+              # A recommendation from your own client-side flagging.
+              sig do
+                returns(
+                  T.nilable(
+                    ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction
+                  )
+                )
+              end
+              attr_reader :client_action
+
+              sig do
+                params(
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::OrHash
+                    )
+                ).void
+              end
+              attr_writer :client_action
+
               # The original content payload
               sig do
                 returns(
@@ -6781,6 +7007,11 @@ module ModerationAPI
               sig { returns(T.nilable(T::Boolean)) }
               attr_accessor :flagged
 
+              # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              # when no fields were flagged or the content is not an object.
+              sig { returns(T::Array[String]) }
+              attr_accessor :flagged_fields
+
               # Moderation labels applied to the content
               sig do
                 returns(
@@ -6823,6 +7054,10 @@ module ModerationAPI
                   id: String,
                   author_id: T.nilable(String),
                   channel_key: T.nilable(String),
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::OrHash
+                    ),
                   content:
                     T.any(
                       ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Text::OrHash,
@@ -6833,6 +7068,7 @@ module ModerationAPI
                     ),
                   conversation_id: T.nilable(String),
                   flagged: T.nilable(T::Boolean),
+                  flagged_fields: T::Array[String],
                   labels:
                     T.nilable(
                       T::Array[
@@ -6856,12 +7092,17 @@ module ModerationAPI
                 # The channel the content was submitted to, identified by your customer-defined
                 # channel key.
                 channel_key:,
+                # A recommendation from your own client-side flagging.
+                client_action:,
                 # The original content payload
                 content:,
                 # Conversation grouping ID, if any
                 conversation_id:,
                 # Whether the content was flagged by moderation
                 flagged:,
+                # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+                # when no fields were flagged or the content is not an object.
+                flagged_fields:,
                 # Moderation labels applied to the content
                 labels:,
                 # Detected ISO language code, if available
@@ -6883,6 +7124,10 @@ module ModerationAPI
                     id: String,
                     author_id: T.nilable(String),
                     channel_key: T.nilable(String),
+                    client_action:
+                      T.nilable(
+                        ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction
+                      ),
                     content:
                       T.any(
                         ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::Content::Text,
@@ -6893,6 +7138,7 @@ module ModerationAPI
                       ),
                     conversation_id: T.nilable(String),
                     flagged: T.nilable(T::Boolean),
+                    flagged_fields: T::Array[String],
                     labels:
                       T.nilable(
                         T::Array[
@@ -6912,6 +7158,172 @@ module ModerationAPI
               def to_hash
               end
 
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction,
+                      ModerationAPI::Internal::AnyHash
+                    )
+                  end
+
+                # Your recommendation for the content: allow, review, or reject.
+                sig do
+                  returns(
+                    ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action::OrSymbol
+                  )
+                end
+                attr_accessor :action
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                sig do
+                  returns(
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :behavior
+
+                sig do
+                  params(
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                  ).void
+                end
+                attr_writer :behavior
+
+                # A human-readable explanation for your recommendation.
+                sig { returns(T.nilable(String)) }
+                attr_reader :reason
+
+                sig { params(reason: String).void }
+                attr_writer :reason
+
+                # Where your recommendation came from, e.g. "banned-ip".
+                sig { returns(T.nilable(String)) }
+                attr_reader :source
+
+                sig { params(source: String).void }
+                attr_writer :source
+
+                # A recommendation from your own client-side flagging.
+                sig do
+                  params(
+                    action:
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action::OrSymbol,
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                    reason: String,
+                    source: String
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # Your recommendation for the content: allow, review, or reject.
+                  action:,
+                  # How your recommendation combines with ours. Defaults to 'escalate', which only
+                  # applies it when stricter than ours; 'override' replaces ours outright.
+                  behavior: nil,
+                  # A human-readable explanation for your recommendation.
+                  reason: nil,
+                  # Where your recommendation came from, e.g. "banned-ip".
+                  source: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      action:
+                        ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action::OrSymbol,
+                      behavior:
+                        ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                      reason: String,
+                      source: String
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # Your recommendation for the content: allow, review, or reject.
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  REVIEW =
+                    T.let(
+                      :review,
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  ALLOW =
+                    T.let(
+                      :allow,
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  REJECT =
+                    T.let(
+                      :reject,
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  OVERRIDE =
+                    T.let(
+                      :override,
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+                  ESCALATE =
+                    T.let(
+                      :escalate,
+                      ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemAction::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+
               # The original content payload
               module Content
                 extend ModerationAPI::Internal::Type::Union
@@ -8532,6 +8944,26 @@ module ModerationAPI
               sig { returns(T.nilable(String)) }
               attr_accessor :channel_key
 
+              # A recommendation from your own client-side flagging.
+              sig do
+                returns(
+                  T.nilable(
+                    ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction
+                  )
+                )
+              end
+              attr_reader :client_action
+
+              sig do
+                params(
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::OrHash
+                    )
+                ).void
+              end
+              attr_writer :client_action
+
               # The original content payload
               sig do
                 returns(
@@ -8554,6 +8986,11 @@ module ModerationAPI
               sig { returns(T.nilable(T::Boolean)) }
               attr_accessor :flagged
 
+              # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              # when no fields were flagged or the content is not an object.
+              sig { returns(T::Array[String]) }
+              attr_accessor :flagged_fields
+
               # Moderation labels applied to the content
               sig do
                 returns(
@@ -8596,6 +9033,10 @@ module ModerationAPI
                   id: String,
                   author_id: T.nilable(String),
                   channel_key: T.nilable(String),
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::OrHash
+                    ),
                   content:
                     T.any(
                       ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Text::OrHash,
@@ -8606,6 +9047,7 @@ module ModerationAPI
                     ),
                   conversation_id: T.nilable(String),
                   flagged: T.nilable(T::Boolean),
+                  flagged_fields: T::Array[String],
                   labels:
                     T.nilable(
                       T::Array[
@@ -8629,12 +9071,17 @@ module ModerationAPI
                 # The channel the content was submitted to, identified by your customer-defined
                 # channel key.
                 channel_key:,
+                # A recommendation from your own client-side flagging.
+                client_action:,
                 # The original content payload
                 content:,
                 # Conversation grouping ID, if any
                 conversation_id:,
                 # Whether the content was flagged by moderation
                 flagged:,
+                # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+                # when no fields were flagged or the content is not an object.
+                flagged_fields:,
                 # Moderation labels applied to the content
                 labels:,
                 # Detected ISO language code, if available
@@ -8656,6 +9103,10 @@ module ModerationAPI
                     id: String,
                     author_id: T.nilable(String),
                     channel_key: T.nilable(String),
+                    client_action:
+                      T.nilable(
+                        ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction
+                      ),
                     content:
                       T.any(
                         ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::Content::Text,
@@ -8666,6 +9117,7 @@ module ModerationAPI
                       ),
                     conversation_id: T.nilable(String),
                     flagged: T.nilable(T::Boolean),
+                    flagged_fields: T::Array[String],
                     labels:
                       T.nilable(
                         T::Array[
@@ -8685,6 +9137,172 @@ module ModerationAPI
               def to_hash
               end
 
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction,
+                      ModerationAPI::Internal::AnyHash
+                    )
+                  end
+
+                # Your recommendation for the content: allow, review, or reject.
+                sig do
+                  returns(
+                    ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action::OrSymbol
+                  )
+                end
+                attr_accessor :action
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                sig do
+                  returns(
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :behavior
+
+                sig do
+                  params(
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                  ).void
+                end
+                attr_writer :behavior
+
+                # A human-readable explanation for your recommendation.
+                sig { returns(T.nilable(String)) }
+                attr_reader :reason
+
+                sig { params(reason: String).void }
+                attr_writer :reason
+
+                # Where your recommendation came from, e.g. "banned-ip".
+                sig { returns(T.nilable(String)) }
+                attr_reader :source
+
+                sig { params(source: String).void }
+                attr_writer :source
+
+                # A recommendation from your own client-side flagging.
+                sig do
+                  params(
+                    action:
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action::OrSymbol,
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                    reason: String,
+                    source: String
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # Your recommendation for the content: allow, review, or reject.
+                  action:,
+                  # How your recommendation combines with ours. Defaults to 'escalate', which only
+                  # applies it when stricter than ours; 'override' replaces ours outright.
+                  behavior: nil,
+                  # A human-readable explanation for your recommendation.
+                  reason: nil,
+                  # Where your recommendation came from, e.g. "banned-ip".
+                  source: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      action:
+                        ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action::OrSymbol,
+                      behavior:
+                        ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                      reason: String,
+                      source: String
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # Your recommendation for the content: allow, review, or reject.
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  REVIEW =
+                    T.let(
+                      :review,
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  ALLOW =
+                    T.let(
+                      :allow,
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  REJECT =
+                    T.let(
+                      :reject,
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  OVERRIDE =
+                    T.let(
+                      :override,
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+                  ESCALATE =
+                    T.let(
+                      :escalate,
+                      ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemRejected::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+
               # The original content payload
               module Content
                 extend ModerationAPI::Internal::Type::Union
@@ -10303,6 +10921,26 @@ module ModerationAPI
               sig { returns(T.nilable(String)) }
               attr_accessor :channel_key
 
+              # A recommendation from your own client-side flagging.
+              sig do
+                returns(
+                  T.nilable(
+                    ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction
+                  )
+                )
+              end
+              attr_reader :client_action
+
+              sig do
+                params(
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::OrHash
+                    )
+                ).void
+              end
+              attr_writer :client_action
+
               # The original content payload
               sig do
                 returns(
@@ -10325,6 +10963,11 @@ module ModerationAPI
               sig { returns(T.nilable(T::Boolean)) }
               attr_accessor :flagged
 
+              # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+              # when no fields were flagged or the content is not an object.
+              sig { returns(T::Array[String]) }
+              attr_accessor :flagged_fields
+
               # Moderation labels applied to the content
               sig do
                 returns(
@@ -10367,6 +11010,10 @@ module ModerationAPI
                   id: String,
                   author_id: T.nilable(String),
                   channel_key: T.nilable(String),
+                  client_action:
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::OrHash
+                    ),
                   content:
                     T.any(
                       ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Text::OrHash,
@@ -10377,6 +11024,7 @@ module ModerationAPI
                     ),
                   conversation_id: T.nilable(String),
                   flagged: T.nilable(T::Boolean),
+                  flagged_fields: T::Array[String],
                   labels:
                     T.nilable(
                       T::Array[
@@ -10400,12 +11048,17 @@ module ModerationAPI
                 # The channel the content was submitted to, identified by your customer-defined
                 # channel key.
                 channel_key:,
+                # A recommendation from your own client-side flagging.
+                client_action:,
                 # The original content payload
                 content:,
                 # Conversation grouping ID, if any
                 conversation_id:,
                 # Whether the content was flagged by moderation
                 flagged:,
+                # For object content, the field keys (e.g. "bio") that triggered a flag. Empty
+                # when no fields were flagged or the content is not an object.
+                flagged_fields:,
                 # Moderation labels applied to the content
                 labels:,
                 # Detected ISO language code, if available
@@ -10427,6 +11080,10 @@ module ModerationAPI
                     id: String,
                     author_id: T.nilable(String),
                     channel_key: T.nilable(String),
+                    client_action:
+                      T.nilable(
+                        ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction
+                      ),
                     content:
                       T.any(
                         ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::Content::Text,
@@ -10437,6 +11094,7 @@ module ModerationAPI
                       ),
                     conversation_id: T.nilable(String),
                     flagged: T.nilable(T::Boolean),
+                    flagged_fields: T::Array[String],
                     labels:
                       T.nilable(
                         T::Array[
@@ -10456,6 +11114,172 @@ module ModerationAPI
               def to_hash
               end
 
+              class ClientAction < ModerationAPI::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction,
+                      ModerationAPI::Internal::AnyHash
+                    )
+                  end
+
+                # Your recommendation for the content: allow, review, or reject.
+                sig do
+                  returns(
+                    ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action::OrSymbol
+                  )
+                end
+                attr_accessor :action
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                sig do
+                  returns(
+                    T.nilable(
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :behavior
+
+                sig do
+                  params(
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior::OrSymbol
+                  ).void
+                end
+                attr_writer :behavior
+
+                # A human-readable explanation for your recommendation.
+                sig { returns(T.nilable(String)) }
+                attr_reader :reason
+
+                sig { params(reason: String).void }
+                attr_writer :reason
+
+                # Where your recommendation came from, e.g. "banned-ip".
+                sig { returns(T.nilable(String)) }
+                attr_reader :source
+
+                sig { params(source: String).void }
+                attr_writer :source
+
+                # A recommendation from your own client-side flagging.
+                sig do
+                  params(
+                    action:
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action::OrSymbol,
+                    behavior:
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                    reason: String,
+                    source: String
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # Your recommendation for the content: allow, review, or reject.
+                  action:,
+                  # How your recommendation combines with ours. Defaults to 'escalate', which only
+                  # applies it when stricter than ours; 'override' replaces ours outright.
+                  behavior: nil,
+                  # A human-readable explanation for your recommendation.
+                  reason: nil,
+                  # Where your recommendation came from, e.g. "banned-ip".
+                  source: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      action:
+                        ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action::OrSymbol,
+                      behavior:
+                        ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior::OrSymbol,
+                      reason: String,
+                      source: String
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # Your recommendation for the content: allow, review, or reject.
+                module Action
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  REVIEW =
+                    T.let(
+                      :review,
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  ALLOW =
+                    T.let(
+                      :allow,
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+                  REJECT =
+                    T.let(
+                      :reject,
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Action::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+
+                # How your recommendation combines with ours. Defaults to 'escalate', which only
+                # applies it when stricter than ours; 'override' replaces ours outright.
+                module Behavior
+                  extend ModerationAPI::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  OVERRIDE =
+                    T.let(
+                      :override,
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+                  ESCALATE =
+                    T.let(
+                      :escalate,
+                      ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        ModerationAPI::WebhookEvent::QueueItemAllowed::Data::Object::Item::ClientAction::Behavior::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+
               # The original content payload
               module Content
                 extend ModerationAPI::Internal::Type::Union