feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 34
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/moderation-api/moderation-api-c71ba49247240f25460ea025f4cabbee8032cb2e30bbd04b52dd10853fabb3bf.yml
-openapi_spec_hash: 6f03994848e51532cb4d268d9542958d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/moderation-api/moderation-api-249bb8b527da76961b59a5b6c7d38ce38b3f02d8b79bcb2ee50e371f6a546e59.yml
+openapi_spec_hash: 8dbdf350a026301960c74d8045398ea2
 config_hash: 6e090a71f4d354167d93b4534a0e7f05

src/moderation_api/types/content_submit_response.py

@@ -12,6 +12,8 @@
     "Author",
     "AuthorBlock",
     "AuthorTrustLevel",
+    "Casebook",
+    "CasebookTopic",
     "Content",
     "ContentModifiedModifiedNestedObjectContentContentModifiedModifiedNestedObjectContentItem",
     "ContentModifiedModifiedNestedObjectContentContentModifiedModifiedNestedObjectContentItemText",
@@ -75,6 +77,57 @@ class Author(BaseModel):
     """The author's ID from your system"""
 
 
+class CasebookTopic(BaseModel):
+    """
+    The topic the closest matching case is filed under, or null when it has not been grouped into one yet.
+    """
+
+    id: str
+
+    label: str
+
+
+class Casebook(BaseModel):
+    """
+    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.
+    """
+
+    agreement: float
+    """
+    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.
+    """
+
+    case_count: float
+    """How many of your past cases backed this ruling."""
+
+    confidence: float
+    """
+    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.
+    """
+
+    similarity: float
+    """How close the nearest matching case is, from 0 to 1.
+
+    1 means the content is identical to something you have already decided.
+    """
+
+    topic: Optional[CasebookTopic] = None
+    """
+    The topic the closest matching case is filed under, or null when it has not been
+    grouped into one yet.
+    """
+
+    verdict: Literal["allow", "reject"]
+    """The ruling your past decisions point to for this content."""
+
+
 class ContentModifiedModifiedNestedObjectContentContentModifiedModifiedNestedObjectContentItemText(BaseModel):
     """Text"""
 
@@ -364,6 +417,7 @@ class Recommendation(BaseModel):
                 "rule_default",
                 "rule_fallback",
                 "client_override",
+                "casebook_match",
             ],
             str,
         ]
@@ -391,6 +445,15 @@ class ContentSubmitResponse(BaseModel):
     Requires you to send authorId when submitting content.
     """
 
+    casebook: Optional[Casebook] = None
+    """
+    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.
+    """
+
     content: Content
     """Potentially modified content."""