moderation_api 1.23.0__tar.gz → 1.25.0__tar.gz

moderation_api-1.25.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.25.0"
+}

{moderation_api-1.23.0 → moderation_api-1.25.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.25.0 (2026-06-18)
+
+Full Changelog: [v1.24.0...v1.25.0](https://github.com/moderation-api/sdk-python/compare/v1.24.0...v1.25.0)
+
+### Features
+
+* **api:** api update ([99f9085](https://github.com/moderation-api/sdk-python/commit/99f9085f211b55811acc687d41c5df778f822d4c))
+
+## 1.24.0 (2026-06-02)
+
+Full Changelog: [v1.23.0...v1.24.0](https://github.com/moderation-api/sdk-python/compare/v1.23.0...v1.24.0)
+
+### Features
+
+* **api:** api update ([45d1814](https://github.com/moderation-api/sdk-python/commit/45d18143451c84ec01a86e55178901674b5bb5e3))
+
 ## 1.23.0 (2026-06-01)
 
 Full Changelog: [v1.22.0...v1.23.0](https://github.com/moderation-api/sdk-python/compare/v1.22.0...v1.23.0)

{moderation_api-1.23.0 → moderation_api-1.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: moderation_api
-Version: 1.23.0
+Version: 1.25.0
 Summary: The official Python library for the moderation-api API
 Project-URL: Homepage, https://github.com/moderation-api/sdk-python
 Project-URL: Repository, https://github.com/moderation-api/sdk-python
@@ -165,11 +165,14 @@ from moderation_api import ModerationAPI
 
 client = ModerationAPI()
 
-author = client.authors.create(
-    external_id="external_id",
-    metadata={},
+response = client.content.submit(
+    content={
+        "text": "text",
+        "type": "text",
+    },
+    client_action={"action": "review"},
 )
-print(author.metadata)
+print(response.client_action)
 ```
 
 ## Handling errors

{moderation_api-1.23.0 → moderation_api-1.25.0}/README.md

@@ -130,11 +130,14 @@ from moderation_api import ModerationAPI
 
 client = ModerationAPI()
 
-author = client.authors.create(
-    external_id="external_id",
-    metadata={},
+response = client.content.submit(
+    content={
+        "text": "text",
+        "type": "text",
+    },
+    client_action={"action": "review"},
 )
-print(author.metadata)
+print(response.client_action)
 ```
 
 ## Handling errors

{moderation_api-1.23.0 → moderation_api-1.25.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "moderation_api"
-version = "1.23.0"
+version = "1.25.0"
 description = "The official Python library for the moderation-api API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{moderation_api-1.23.0 → moderation_api-1.25.0}/src/moderation_api/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "moderation_api"
-__version__ = "1.23.0"  # x-release-please-version
+__version__ = "1.25.0"  # x-release-please-version

{moderation_api-1.23.0 → moderation_api-1.25.0}/src/moderation_api/resources/content.py

@@ -50,11 +50,12 @@ class ContentResource(SyncAPIResource):
         content: content_submit_params.Content,
         author_id: str | Omit = omit,
         channel: str | Omit = omit,
+        client_action: content_submit_params.ClientAction | Omit = omit,
         content_id: str | Omit = omit,
         conversation_id: str | Omit = omit,
         do_not_store: bool | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
-        meta_type: Literal["profile", "message", "post", "comment", "event", "product", "review", "other"]
+        meta_type: Literal["profile", "message", "post", "comment", "event", "product", "review", "voice", "other"]
         | Omit = omit,
         policies: Iterable[content_submit_params.Policy] | Omit = omit,
         timestamp: float | Omit = omit,
@@ -74,6 +75,10 @@ class ContentResource(SyncAPIResource):
           channel: Provide a channel ID or key. Will use the project's default channel if not
               provided.
 
+          client_action: A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+              third-party tool). Feeds the rules engine and can escalate or override the
+              recommended action. Does not change whether our analysis flagged the content.
+
           content_id: The unique ID of the content in your database.
 
           conversation_id: For example the ID of a chat room or a post
@@ -104,6 +109,7 @@ class ContentResource(SyncAPIResource):
                     "content": content,
                     "author_id": author_id,
                     "channel": channel,
+                    "client_action": client_action,
                     "content_id": content_id,
                     "conversation_id": conversation_id,
                     "do_not_store": do_not_store,
@@ -147,11 +153,12 @@ class AsyncContentResource(AsyncAPIResource):
         content: content_submit_params.Content,
         author_id: str | Omit = omit,
         channel: str | Omit = omit,
+        client_action: content_submit_params.ClientAction | Omit = omit,
         content_id: str | Omit = omit,
         conversation_id: str | Omit = omit,
         do_not_store: bool | Omit = omit,
         metadata: Dict[str, object] | Omit = omit,
-        meta_type: Literal["profile", "message", "post", "comment", "event", "product", "review", "other"]
+        meta_type: Literal["profile", "message", "post", "comment", "event", "product", "review", "voice", "other"]
         | Omit = omit,
         policies: Iterable[content_submit_params.Policy] | Omit = omit,
         timestamp: float | Omit = omit,
@@ -171,6 +178,10 @@ class AsyncContentResource(AsyncAPIResource):
           channel: Provide a channel ID or key. Will use the project's default channel if not
               provided.
 
+          client_action: A recommendation from your own client-side flagging (e.g. a banned-IP list or a
+              third-party tool). Feeds the rules engine and can escalate or override the
+              recommended action. Does not change whether our analysis flagged the content.
+
           content_id: The unique ID of the content in your database.
 
           conversation_id: For example the ID of a chat room or a post
@@ -201,6 +212,7 @@ class AsyncContentResource(AsyncAPIResource):
                     "content": content,
                     "author_id": author_id,
                     "channel": channel,
+                    "client_action": client_action,
                     "content_id": content_id,
                     "conversation_id": conversation_id,
                     "do_not_store": do_not_store,

{moderation_api-1.23.0 → moderation_api-1.25.0}/src/moderation_api/types/content_submit_params.py

@@ -21,6 +21,7 @@ __all__ = [
     "ContentObjectDataImage",
     "ContentObjectDataVideo",
     "ContentObjectDataAudio",
+    "ClientAction",
     "Policy",
     "PolicyToxicity",
     "PolicyPersonalInformation",
@@ -69,6 +70,14 @@ class ContentSubmitParams(TypedDict, total=False):
     Will use the project's default channel if not provided.
     """
 
+    client_action: Annotated[ClientAction, PropertyInfo(alias="clientAction")]
+    """A recommendation from your own client-side flagging (e.g.
+
+    a banned-IP list or a third-party tool). Feeds the rules engine and can escalate
+    or override the recommended action. Does not change whether our analysis flagged
+    the content.
+    """
+
     content_id: Annotated[str, PropertyInfo(alias="contentId")]
     """The unique ID of the content in your database."""
 
@@ -82,7 +91,7 @@ class ContentSubmitParams(TypedDict, total=False):
     """Any metadata you want to store with the content"""
 
     meta_type: Annotated[
-        Literal["profile", "message", "post", "comment", "event", "product", "review", "other"],
+        Literal["profile", "message", "post", "comment", "event", "product", "review", "voice", "other"],
         PropertyInfo(alias="metaType"),
     ]
     """The meta type of content being moderated"""
@@ -200,6 +209,29 @@ class ContentObject(TypedDict, total=False):
 Content: TypeAlias = Union[ContentText, ContentImage, ContentVideo, ContentAudio, ContentObject]
 
 
+class ClientAction(TypedDict, total=False):
+    """A recommendation from your own client-side flagging (e.g.
+
+    a banned-IP list or a third-party tool). Feeds the rules engine and can escalate or override the recommended action. Does not change whether our analysis flagged the content.
+    """
+
+    action: Required[Literal["review", "allow", "reject"]]
+    """Your recommendation for the content: allow, review, or reject."""
+
+    behavior: Literal["override", "escalate"]
+    """How your recommendation combines with ours.
+
+    Defaults to 'escalate', which only applies it when stricter than ours;
+    'override' replaces ours outright.
+    """
+
+    reason: str
+    """A human-readable explanation for your recommendation."""
+
+    source: str
+    """Where your recommendation came from, e.g. "banned-ip"."""
+
+
 class PolicyToxicity(TypedDict, total=False):
     id: Required[Literal["toxicity"]]
 

{moderation_api-1.23.0 → moderation_api-1.25.0}/src/moderation_api/types/content_submit_response.py

@@ -351,6 +351,7 @@ class Recommendation(BaseModel):
             "rule_match",
             "rule_default",
             "rule_fallback",
+            "client_override",
         ]
     ]
     """The reason code for the recommendation.

{moderation_api-1.23.0 → moderation_api-1.25.0}/tests/api_resources/test_content.py

@@ -38,6 +38,12 @@ class TestContent:
             },
             author_id="authorId",
             channel="channel",
+            client_action={
+                "action": "review",
+                "behavior": "override",
+                "reason": "reason",
+                "source": "source",
+            },
             content_id="contentId",
             conversation_id="conversationId",
             do_not_store=True,
@@ -113,6 +119,12 @@ class TestAsyncContent:
             },
             author_id="authorId",
             channel="channel",
+            client_action={
+                "action": "review",
+                "behavior": "override",
+                "reason": "reason",
+                "source": "source",
+            },
             content_id="contentId",
             conversation_id="conversationId",
             do_not_store=True,

moderation_api-1.23.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.23.0"
-}