moderation_api 1.34.0__tar.gz → 1.35.0__tar.gz

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

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

{moderation_api-1.34.0 → moderation_api-1.35.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.35.0 (2026-08-20)
+
+Full Changelog: [v1.34.0...v1.35.0](https://github.com/moderation-api/sdk-python/compare/v1.34.0...v1.35.0)
+
+### Features
+
+* **api:** webhooks and stream ([4f4bf9f](https://github.com/moderation-api/sdk-python/commit/4f4bf9f2d1e2b6c5ddea270e16fd4d8f10600618))
+
 ## 1.34.0 (2026-08-14)
 
 Full Changelog: [v1.33.0...v1.34.0](https://github.com/moderation-api/sdk-python/compare/v1.33.0...v1.34.0)

{moderation_api-1.34.0 → moderation_api-1.35.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: moderation_api
-Version: 1.34.0
+Version: 1.35.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

{moderation_api-1.34.0 → moderation_api-1.35.0}/api.md

@@ -92,6 +92,7 @@ from moderation_api.types import ContentSubmitResponse
 
 Methods:
 
+- <code title="get /stream">client.content.<a href="./src/moderation_api/resources/content.py">stream</a>() -> None</code>
 - <code title="post /moderate">client.content.<a href="./src/moderation_api/resources/content.py">submit</a>(\*\*<a href="src/moderation_api/types/content_submit_params.py">params</a>) -> <a href="./src/moderation_api/types/content_submit_response.py">ContentSubmitResponse</a></code>
 
 # Account
@@ -151,3 +152,37 @@ Methods:
 
 - <code title="post /wordlist/{id}/words">client.wordlist.words.<a href="./src/moderation_api/resources/wordlist/words.py">add</a>(id, \*\*<a href="src/moderation_api/types/wordlist/word_add_params.py">params</a>) -> <a href="./src/moderation_api/types/wordlist/word_add_response.py">WordAddResponse</a></code>
 - <code title="delete /wordlist/{id}/words">client.wordlist.words.<a href="./src/moderation_api/resources/wordlist/words.py">remove</a>(id, \*\*<a href="src/moderation_api/types/wordlist/word_remove_params.py">params</a>) -> <a href="./src/moderation_api/types/wordlist/word_remove_response.py">WordRemoveResponse</a></code>
+
+# Webhooks
+
+Types:
+
+```python
+from moderation_api.types import (
+    WebhookCreateResponse,
+    WebhookRetrieveResponse,
+    WebhookUpdateResponse,
+    WebhookListResponse,
+    WebhookDeleteResponse,
+)
+```
+
+Methods:
+
+- <code title="post /webhooks">client.webhooks.<a href="./src/moderation_api/resources/webhooks.py">create</a>(\*\*<a href="src/moderation_api/types/webhook_create_params.py">params</a>) -> <a href="./src/moderation_api/types/webhook_create_response.py">WebhookCreateResponse</a></code>
+- <code title="get /webhooks/{id}">client.webhooks.<a href="./src/moderation_api/resources/webhooks.py">retrieve</a>(id) -> <a href="./src/moderation_api/types/webhook_retrieve_response.py">WebhookRetrieveResponse</a></code>
+- <code title="put /webhooks/{id}">client.webhooks.<a href="./src/moderation_api/resources/webhooks.py">update</a>(id, \*\*<a href="src/moderation_api/types/webhook_update_params.py">params</a>) -> <a href="./src/moderation_api/types/webhook_update_response.py">WebhookUpdateResponse</a></code>
+- <code title="get /webhooks">client.webhooks.<a href="./src/moderation_api/resources/webhooks.py">list</a>() -> <a href="./src/moderation_api/types/webhook_list_response.py">WebhookListResponse</a></code>
+- <code title="delete /webhooks/{id}">client.webhooks.<a href="./src/moderation_api/resources/webhooks.py">delete</a>(id) -> <a href="./src/moderation_api/types/webhook_delete_response.py">WebhookDeleteResponse</a></code>
+
+# WebhookSecret
+
+Types:
+
+```python
+from moderation_api.types import WebhookSecretRetrieveResponse
+```
+
+Methods:
+
+- <code title="get /webhook-secret">client.webhook_secret.<a href="./src/moderation_api/resources/webhook_secret.py">retrieve</a>() -> <a href="./src/moderation_api/types/webhook_secret_retrieve_response.py">WebhookSecretRetrieveResponse</a></code>

{moderation_api-1.34.0 → moderation_api-1.35.0}/pyproject.toml

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

{moderation_api-1.34.0 → moderation_api-1.35.0}/src/moderation_api/_client.py

@@ -35,12 +35,14 @@ from ._base_client import (
 )
 
 if TYPE_CHECKING:
-    from .resources import auth, queue, account, actions, authors, content, wordlist
+    from .resources import auth, queue, account, actions, authors, content, webhooks, wordlist, webhook_secret
     from .resources.auth import AuthResource, AsyncAuthResource
     from .resources.account import AccountResource, AsyncAccountResource
     from .resources.authors import AuthorsResource, AsyncAuthorsResource
     from .resources.content import ContentResource, AsyncContentResource
+    from .resources.webhooks import WebhooksResource, AsyncWebhooksResource
     from .resources.queue.queue import QueueResource, AsyncQueueResource
+    from .resources.webhook_secret import WebhookSecretResource, AsyncWebhookSecretResource
     from .resources.actions.actions import ActionsResource, AsyncActionsResource
     from .resources.wordlist.wordlist import WordlistResource, AsyncWordlistResource
 
@@ -97,6 +99,7 @@ class ModerationAPI(SyncAPIClient):
 
         if base_url is None:
             base_url = os.environ.get("MODERATION_API_BASE_URL")
+        self._base_url_overridden = base_url is not None
         if base_url is None:
             base_url = f"https://api.moderationapi.com/v1"
 
@@ -162,6 +165,18 @@ class ModerationAPI(SyncAPIClient):
 
         return WordlistResource(self)
 
+    @cached_property
+    def webhooks(self) -> WebhooksResource:
+        from .resources.webhooks import WebhooksResource
+
+        return WebhooksResource(self)
+
+    @cached_property
+    def webhook_secret(self) -> WebhookSecretResource:
+        from .resources.webhook_secret import WebhookSecretResource
+
+        return WebhookSecretResource(self)
+
     @cached_property
     def with_raw_response(self) -> ModerationAPIWithRawResponse:
         return ModerationAPIWithRawResponse(self)
@@ -226,7 +241,7 @@ class ModerationAPI(SyncAPIClient):
             params = set_default_query
 
         http_client = http_client or self._client
-        return self.__class__(
+        client = self.__class__(
             secret_key=secret_key or self.secret_key,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
@@ -236,6 +251,8 @@ class ModerationAPI(SyncAPIClient):
             default_query=params,
             **_extra_kwargs,
         )
+        client._base_url_overridden = self._base_url_overridden or base_url is not None
+        return client
 
     # Alias for `copy` for nicer inline usage, e.g.
     # client.with_options(timeout=10).foo.create(...)
@@ -316,6 +333,7 @@ class AsyncModerationAPI(AsyncAPIClient):
 
         if base_url is None:
             base_url = os.environ.get("MODERATION_API_BASE_URL")
+        self._base_url_overridden = base_url is not None
         if base_url is None:
             base_url = f"https://api.moderationapi.com/v1"
 
@@ -381,6 +399,18 @@ class AsyncModerationAPI(AsyncAPIClient):
 
         return AsyncWordlistResource(self)
 
+    @cached_property
+    def webhooks(self) -> AsyncWebhooksResource:
+        from .resources.webhooks import AsyncWebhooksResource
+
+        return AsyncWebhooksResource(self)
+
+    @cached_property
+    def webhook_secret(self) -> AsyncWebhookSecretResource:
+        from .resources.webhook_secret import AsyncWebhookSecretResource
+
+        return AsyncWebhookSecretResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncModerationAPIWithRawResponse:
         return AsyncModerationAPIWithRawResponse(self)
@@ -445,7 +475,7 @@ class AsyncModerationAPI(AsyncAPIClient):
             params = set_default_query
 
         http_client = http_client or self._client
-        return self.__class__(
+        client = self.__class__(
             secret_key=secret_key or self.secret_key,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
@@ -455,6 +485,8 @@ class AsyncModerationAPI(AsyncAPIClient):
             default_query=params,
             **_extra_kwargs,
         )
+        client._base_url_overridden = self._base_url_overridden or base_url is not None
+        return client
 
     # Alias for `copy` for nicer inline usage, e.g.
     # client.with_options(timeout=10).foo.create(...)
@@ -542,6 +574,18 @@ class ModerationAPIWithRawResponse:
 
         return WordlistResourceWithRawResponse(self._client.wordlist)
 
+    @cached_property
+    def webhooks(self) -> webhooks.WebhooksResourceWithRawResponse:
+        from .resources.webhooks import WebhooksResourceWithRawResponse
+
+        return WebhooksResourceWithRawResponse(self._client.webhooks)
+
+    @cached_property
+    def webhook_secret(self) -> webhook_secret.WebhookSecretResourceWithRawResponse:
+        from .resources.webhook_secret import WebhookSecretResourceWithRawResponse
+
+        return WebhookSecretResourceWithRawResponse(self._client.webhook_secret)
+
 
 class AsyncModerationAPIWithRawResponse:
     _client: AsyncModerationAPI
@@ -591,6 +635,18 @@ class AsyncModerationAPIWithRawResponse:
 
         return AsyncWordlistResourceWithRawResponse(self._client.wordlist)
 
+    @cached_property
+    def webhooks(self) -> webhooks.AsyncWebhooksResourceWithRawResponse:
+        from .resources.webhooks import AsyncWebhooksResourceWithRawResponse
+
+        return AsyncWebhooksResourceWithRawResponse(self._client.webhooks)
+
+    @cached_property
+    def webhook_secret(self) -> webhook_secret.AsyncWebhookSecretResourceWithRawResponse:
+        from .resources.webhook_secret import AsyncWebhookSecretResourceWithRawResponse
+
+        return AsyncWebhookSecretResourceWithRawResponse(self._client.webhook_secret)
+
 
 class ModerationAPIWithStreamedResponse:
     _client: ModerationAPI
@@ -640,6 +696,18 @@ class ModerationAPIWithStreamedResponse:
 
         return WordlistResourceWithStreamingResponse(self._client.wordlist)
 
+    @cached_property
+    def webhooks(self) -> webhooks.WebhooksResourceWithStreamingResponse:
+        from .resources.webhooks import WebhooksResourceWithStreamingResponse
+
+        return WebhooksResourceWithStreamingResponse(self._client.webhooks)
+
+    @cached_property
+    def webhook_secret(self) -> webhook_secret.WebhookSecretResourceWithStreamingResponse:
+        from .resources.webhook_secret import WebhookSecretResourceWithStreamingResponse
+
+        return WebhookSecretResourceWithStreamingResponse(self._client.webhook_secret)
+
 
 class AsyncModerationAPIWithStreamedResponse:
     _client: AsyncModerationAPI
@@ -689,6 +757,18 @@ class AsyncModerationAPIWithStreamedResponse:
 
         return AsyncWordlistResourceWithStreamingResponse(self._client.wordlist)
 
+    @cached_property
+    def webhooks(self) -> webhooks.AsyncWebhooksResourceWithStreamingResponse:
+        from .resources.webhooks import AsyncWebhooksResourceWithStreamingResponse
+
+        return AsyncWebhooksResourceWithStreamingResponse(self._client.webhooks)
+
+    @cached_property
+    def webhook_secret(self) -> webhook_secret.AsyncWebhookSecretResourceWithStreamingResponse:
+        from .resources.webhook_secret import AsyncWebhookSecretResourceWithStreamingResponse
+
+        return AsyncWebhookSecretResourceWithStreamingResponse(self._client.webhook_secret)
+
 
 Client = ModerationAPI
 

{moderation_api-1.34.0 → moderation_api-1.35.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.34.0"  # x-release-please-version
+__version__ = "1.35.0"  # x-release-please-version

{moderation_api-1.34.0 → moderation_api-1.35.0}/src/moderation_api/resources/__init__.py

@@ -48,6 +48,14 @@ from .content import (
     ContentResourceWithStreamingResponse,
     AsyncContentResourceWithStreamingResponse,
 )
+from .webhooks import (
+    WebhooksResource,
+    AsyncWebhooksResource,
+    WebhooksResourceWithRawResponse,
+    AsyncWebhooksResourceWithRawResponse,
+    WebhooksResourceWithStreamingResponse,
+    AsyncWebhooksResourceWithStreamingResponse,
+)
 from .wordlist import (
     WordlistResource,
     AsyncWordlistResource,
@@ -56,6 +64,14 @@ from .wordlist import (
     WordlistResourceWithStreamingResponse,
     AsyncWordlistResourceWithStreamingResponse,
 )
+from .webhook_secret import (
+    WebhookSecretResource,
+    AsyncWebhookSecretResource,
+    WebhookSecretResourceWithRawResponse,
+    AsyncWebhookSecretResourceWithRawResponse,
+    WebhookSecretResourceWithStreamingResponse,
+    AsyncWebhookSecretResourceWithStreamingResponse,
+)
 
 __all__ = [
     "AuthorsResource",
@@ -100,4 +116,16 @@ __all__ = [
     "AsyncWordlistResourceWithRawResponse",
     "WordlistResourceWithStreamingResponse",
     "AsyncWordlistResourceWithStreamingResponse",
+    "WebhooksResource",
+    "AsyncWebhooksResource",
+    "WebhooksResourceWithRawResponse",
+    "AsyncWebhooksResourceWithRawResponse",
+    "WebhooksResourceWithStreamingResponse",
+    "AsyncWebhooksResourceWithStreamingResponse",
+    "WebhookSecretResource",
+    "AsyncWebhookSecretResource",
+    "WebhookSecretResourceWithRawResponse",
+    "AsyncWebhookSecretResourceWithRawResponse",
+    "WebhookSecretResourceWithStreamingResponse",
+    "AsyncWebhookSecretResourceWithStreamingResponse",
 ]

{moderation_api-1.34.0 → moderation_api-1.35.0}/src/moderation_api/resources/content.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..types import content_submit_params
-from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from .._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -44,6 +44,59 @@ class ContentResource(SyncAPIResource):
         """
         return ContentResourceWithStreamingResponse(self)
 
+    def stream(
+        self,
+        *,
+        sec_web_socket_protocol: Literal["moderationapi.v1"],
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """Open a WebSocket to moderate live voice/call audio in real time.
+
+        Speech is
+        transcribed and each finalized utterance is moderated by your enabled text
+        policies; you receive a verdict per utterance as it's spoken.
+
+        **This is a WebSocket upgrade, not a regular HTTP call.** The request body below
+        documents the frames you _send_ over the socket; the `101` response documents
+        the events you _receive_.
+
+        - **Auth:** `Authorization: Bearer <api_key>` on the upgrade. A missing/invalid
+          key closes `4401`; voice not enabled on the plan/channel closes `4403`.
+        - **Subprotocol:** request `moderationapi.v1`.
+        - **Flow:** send one `start` frame, then `media` frames as audio arrives, then
+          `stop` (or disconnect). You receive `session.started`, `utterance.final` per
+          utterance, optional `utterance.partial`/`warning`, and `session.ended`.
+        - **Close codes:** `1000` normal · `1011` server error · `4400` bad request ·
+          `4401` auth failed · `4403` voice not enabled · `4429` concurrency limit.
+
+        See the
+        [Real-time voice guide](https://docs.moderationapi.com/content-moderation/real-time-voice)
+        for the full walkthrough and code examples.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        extra_headers.update({"Sec-WebSocket-Protocol": str(sec_web_socket_protocol)})
+        return self._get(
+            "/stream" if self._client._base_url_overridden else "wss://voice.moderationapi.com/v1/stream",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     def submit(
         self,
         *,
@@ -147,6 +200,59 @@ class AsyncContentResource(AsyncAPIResource):
         """
         return AsyncContentResourceWithStreamingResponse(self)
 
+    async def stream(
+        self,
+        *,
+        sec_web_socket_protocol: Literal["moderationapi.v1"],
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> None:
+        """Open a WebSocket to moderate live voice/call audio in real time.
+
+        Speech is
+        transcribed and each finalized utterance is moderated by your enabled text
+        policies; you receive a verdict per utterance as it's spoken.
+
+        **This is a WebSocket upgrade, not a regular HTTP call.** The request body below
+        documents the frames you _send_ over the socket; the `101` response documents
+        the events you _receive_.
+
+        - **Auth:** `Authorization: Bearer <api_key>` on the upgrade. A missing/invalid
+          key closes `4401`; voice not enabled on the plan/channel closes `4403`.
+        - **Subprotocol:** request `moderationapi.v1`.
+        - **Flow:** send one `start` frame, then `media` frames as audio arrives, then
+          `stop` (or disconnect). You receive `session.started`, `utterance.final` per
+          utterance, optional `utterance.partial`/`warning`, and `session.ended`.
+        - **Close codes:** `1000` normal · `1011` server error · `4400` bad request ·
+          `4401` auth failed · `4403` voice not enabled · `4429` concurrency limit.
+
+        See the
+        [Real-time voice guide](https://docs.moderationapi.com/content-moderation/real-time-voice)
+        for the full walkthrough and code examples.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        extra_headers.update({"Sec-WebSocket-Protocol": str(sec_web_socket_protocol)})
+        return await self._get(
+            "/stream" if self._client._base_url_overridden else "wss://voice.moderationapi.com/v1/stream",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
     async def submit(
         self,
         *,
@@ -234,6 +340,9 @@ class ContentResourceWithRawResponse:
     def __init__(self, content: ContentResource) -> None:
         self._content = content
 
+        self.stream = to_raw_response_wrapper(
+            content.stream,
+        )
         self.submit = to_raw_response_wrapper(
             content.submit,
         )
@@ -243,6 +352,9 @@ class AsyncContentResourceWithRawResponse:
     def __init__(self, content: AsyncContentResource) -> None:
         self._content = content
 
+        self.stream = async_to_raw_response_wrapper(
+            content.stream,
+        )
         self.submit = async_to_raw_response_wrapper(
             content.submit,
         )
@@ -252,6 +364,9 @@ class ContentResourceWithStreamingResponse:
     def __init__(self, content: ContentResource) -> None:
         self._content = content
 
+        self.stream = to_streamed_response_wrapper(
+            content.stream,
+        )
         self.submit = to_streamed_response_wrapper(
             content.submit,
         )
@@ -261,6 +376,9 @@ class AsyncContentResourceWithStreamingResponse:
     def __init__(self, content: AsyncContentResource) -> None:
         self._content = content
 
+        self.stream = async_to_streamed_response_wrapper(
+            content.stream,
+        )
         self.submit = async_to_streamed_response_wrapper(
             content.submit,
         )

moderation_api-1.35.0/src/moderation_api/resources/webhook_secret.py

@@ -0,0 +1,143 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from .._types import Body, Query, Headers, NotGiven, not_given
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.webhook_secret_retrieve_response import WebhookSecretRetrieveResponse
+
+__all__ = ["WebhookSecretResource", "AsyncWebhookSecretResource"]
+
+
+class WebhookSecretResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> WebhookSecretResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/moderation-api/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return WebhookSecretResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> WebhookSecretResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/moderation-api/sdk-python#with_streaming_response
+        """
+        return WebhookSecretResourceWithStreamingResponse(self)
+
+    def retrieve(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> WebhookSecretRetrieveResponse:
+        """
+        Get the signing secret used to sign webhook deliveries for this project,
+        creating one if none exists yet. Verify deliveries by comparing the
+        `modapi-signature` header to HMAC-SHA256(raw request body, secret) hex-encoded.
+        """
+        return self._get(
+            "/webhook-secret",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=WebhookSecretRetrieveResponse,
+        )
+
+
+class AsyncWebhookSecretResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncWebhookSecretResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/moderation-api/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncWebhookSecretResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncWebhookSecretResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/moderation-api/sdk-python#with_streaming_response
+        """
+        return AsyncWebhookSecretResourceWithStreamingResponse(self)
+
+    async def retrieve(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> WebhookSecretRetrieveResponse:
+        """
+        Get the signing secret used to sign webhook deliveries for this project,
+        creating one if none exists yet. Verify deliveries by comparing the
+        `modapi-signature` header to HMAC-SHA256(raw request body, secret) hex-encoded.
+        """
+        return await self._get(
+            "/webhook-secret",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=WebhookSecretRetrieveResponse,
+        )
+
+
+class WebhookSecretResourceWithRawResponse:
+    def __init__(self, webhook_secret: WebhookSecretResource) -> None:
+        self._webhook_secret = webhook_secret
+
+        self.retrieve = to_raw_response_wrapper(
+            webhook_secret.retrieve,
+        )
+
+
+class AsyncWebhookSecretResourceWithRawResponse:
+    def __init__(self, webhook_secret: AsyncWebhookSecretResource) -> None:
+        self._webhook_secret = webhook_secret
+
+        self.retrieve = async_to_raw_response_wrapper(
+            webhook_secret.retrieve,
+        )
+
+
+class WebhookSecretResourceWithStreamingResponse:
+    def __init__(self, webhook_secret: WebhookSecretResource) -> None:
+        self._webhook_secret = webhook_secret
+
+        self.retrieve = to_streamed_response_wrapper(
+            webhook_secret.retrieve,
+        )
+
+
+class AsyncWebhookSecretResourceWithStreamingResponse:
+    def __init__(self, webhook_secret: AsyncWebhookSecretResource) -> None:
+        self._webhook_secret = webhook_secret
+
+        self.retrieve = async_to_streamed_response_wrapper(
+            webhook_secret.retrieve,
+        )