feat(api): update via SDK Studio

stainless-app[bot] · stainless-app[bot] · commit df1dc5d54731 · 2025-10-14T02:01:04.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hyperspell%2Fhyperspell-02e7812c1884f52abc262b661200ba5f97e497d5c981db3e0fdcd45f3df9f1a7.yml
-openapi_spec_hash: 7c4d4f673badcf00e63a2bf17fbc149f
+configured_endpoints: 20
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hyperspell%2Fhyperspell-cd8c28747615d8967e4e20e6fd5b9488a3022fece37f1c4c133c9b8d9c4415f3.yml
+openapi_spec_hash: 2aa6c5d6faa2cbd4038108b5ebc103b3
 config_hash: 331712c9dfb31af34bdab84fd3f7d48d
diff --git a/api.md b/api.md
@@ -6,6 +6,22 @@ from hyperspell.types import QueryResult
 
 # Integrations
 
+Types:
+
+```python
+from hyperspell.types import (
+    IntegrationListResponse,
+    IntegrationConnectResponse,
+    IntegrationRevokeResponse,
+)
+```
+
+Methods:
+
+- <code title="get /integrations/list">client.integrations.<a href="./src/hyperspell/resources/integrations/integrations.py">list</a>() -> <a href="./src/hyperspell/types/integration_list_response.py">IntegrationListResponse</a></code>
+- <code title="get /integrations/{integration_id}/connect">client.integrations.<a href="./src/hyperspell/resources/integrations/integrations.py">connect</a>(integration_id, \*\*<a href="src/hyperspell/types/integration_connect_params.py">params</a>) -> <a href="./src/hyperspell/types/integration_connect_response.py">IntegrationConnectResponse</a></code>
+- <code title="get /integrations/{integration_id}/revoke">client.integrations.<a href="./src/hyperspell/resources/integrations/integrations.py">revoke</a>(integration_id) -> <a href="./src/hyperspell/types/integration_revoke_response.py">IntegrationRevokeResponse</a></code>
+
 ## GoogleCalendar
 
 Types:
diff --git a/src/hyperspell/resources/integrations/integrations.py b/src/hyperspell/resources/integrations/integrations.py
@@ -2,6 +2,10 @@
 
 from __future__ import annotations
 
+from typing import Optional
+
+import httpx
+
 from .slack import (
     SlackResource,
     AsyncSlackResource,
@@ -10,8 +14,17 @@
     SlackResourceWithStreamingResponse,
     AsyncSlackResourceWithStreamingResponse,
 )
+from ...types import integration_connect_params
+from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ..._utils import maybe_transform, async_maybe_transform
 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 .web_crawler import (
     WebCrawlerResource,
     AsyncWebCrawlerResource,
@@ -20,6 +33,7 @@
     WebCrawlerResourceWithStreamingResponse,
     AsyncWebCrawlerResourceWithStreamingResponse,
 )
+from ..._base_client import make_request_options
 from .google_calendar import (
     GoogleCalendarResource,
     AsyncGoogleCalendarResource,
@@ -28,6 +42,9 @@
     GoogleCalendarResourceWithStreamingResponse,
     AsyncGoogleCalendarResourceWithStreamingResponse,
 )
+from ...types.integration_list_response import IntegrationListResponse
+from ...types.integration_revoke_response import IntegrationRevokeResponse
+from ...types.integration_connect_response import IntegrationConnectResponse
 
 __all__ = ["IntegrationsResource", "AsyncIntegrationsResource"]
 
@@ -64,6 +81,99 @@ def with_streaming_response(self) -> IntegrationsResourceWithStreamingResponse:
         """
         return IntegrationsResourceWithStreamingResponse(self)
 
+    def list(
+        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,
+    ) -> IntegrationListResponse:
+        """List all integrations for the user."""
+        return self._get(
+            "/integrations/list",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=IntegrationListResponse,
+        )
+
+    def connect(
+        self,
+        integration_id: str,
+        *,
+        redirect_url: Optional[str] | Omit = omit,
+        # 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,
+    ) -> IntegrationConnectResponse:
+        """
+        Redirects to the connect URL to link an integration.
+
+        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
+        """
+        if not integration_id:
+            raise ValueError(f"Expected a non-empty value for `integration_id` but received {integration_id!r}")
+        return self._get(
+            f"/integrations/{integration_id}/connect",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {"redirect_url": redirect_url}, integration_connect_params.IntegrationConnectParams
+                ),
+            ),
+            cast_to=IntegrationConnectResponse,
+        )
+
+    def revoke(
+        self,
+        integration_id: str,
+        *,
+        # 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,
+    ) -> IntegrationRevokeResponse:
+        """
+        Revokes Hyperspell's access the given provider and deletes all stored
+        credentials and indexed data.
+
+        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
+        """
+        if not integration_id:
+            raise ValueError(f"Expected a non-empty value for `integration_id` but received {integration_id!r}")
+        return self._get(
+            f"/integrations/{integration_id}/revoke",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=IntegrationRevokeResponse,
+        )
+
 
 class AsyncIntegrationsResource(AsyncAPIResource):
     @cached_property
@@ -97,11 +207,114 @@ def with_streaming_response(self) -> AsyncIntegrationsResourceWithStreamingRespo
         """
         return AsyncIntegrationsResourceWithStreamingResponse(self)
 
+    async def list(
+        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,
+    ) -> IntegrationListResponse:
+        """List all integrations for the user."""
+        return await self._get(
+            "/integrations/list",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=IntegrationListResponse,
+        )
+
+    async def connect(
+        self,
+        integration_id: str,
+        *,
+        redirect_url: Optional[str] | Omit = omit,
+        # 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,
+    ) -> IntegrationConnectResponse:
+        """
+        Redirects to the connect URL to link an integration.
+
+        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
+        """
+        if not integration_id:
+            raise ValueError(f"Expected a non-empty value for `integration_id` but received {integration_id!r}")
+        return await self._get(
+            f"/integrations/{integration_id}/connect",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {"redirect_url": redirect_url}, integration_connect_params.IntegrationConnectParams
+                ),
+            ),
+            cast_to=IntegrationConnectResponse,
+        )
+
+    async def revoke(
+        self,
+        integration_id: str,
+        *,
+        # 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,
+    ) -> IntegrationRevokeResponse:
+        """
+        Revokes Hyperspell's access the given provider and deletes all stored
+        credentials and indexed data.
+
+        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
+        """
+        if not integration_id:
+            raise ValueError(f"Expected a non-empty value for `integration_id` but received {integration_id!r}")
+        return await self._get(
+            f"/integrations/{integration_id}/revoke",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=IntegrationRevokeResponse,
+        )
+
 
 class IntegrationsResourceWithRawResponse:
     def __init__(self, integrations: IntegrationsResource) -> None:
         self._integrations = integrations
 
+        self.list = to_raw_response_wrapper(
+            integrations.list,
+        )
+        self.connect = to_raw_response_wrapper(
+            integrations.connect,
+        )
+        self.revoke = to_raw_response_wrapper(
+            integrations.revoke,
+        )
+
     @cached_property
     def google_calendar(self) -> GoogleCalendarResourceWithRawResponse:
         return GoogleCalendarResourceWithRawResponse(self._integrations.google_calendar)
@@ -119,6 +332,16 @@ class AsyncIntegrationsResourceWithRawResponse:
     def __init__(self, integrations: AsyncIntegrationsResource) -> None:
         self._integrations = integrations
 
+        self.list = async_to_raw_response_wrapper(
+            integrations.list,
+        )
+        self.connect = async_to_raw_response_wrapper(
+            integrations.connect,
+        )
+        self.revoke = async_to_raw_response_wrapper(
+            integrations.revoke,
+        )
+
     @cached_property
     def google_calendar(self) -> AsyncGoogleCalendarResourceWithRawResponse:
         return AsyncGoogleCalendarResourceWithRawResponse(self._integrations.google_calendar)
@@ -136,6 +359,16 @@ class IntegrationsResourceWithStreamingResponse:
     def __init__(self, integrations: IntegrationsResource) -> None:
         self._integrations = integrations
 
+        self.list = to_streamed_response_wrapper(
+            integrations.list,
+        )
+        self.connect = to_streamed_response_wrapper(
+            integrations.connect,
+        )
+        self.revoke = to_streamed_response_wrapper(
+            integrations.revoke,
+        )
+
     @cached_property
     def google_calendar(self) -> GoogleCalendarResourceWithStreamingResponse:
         return GoogleCalendarResourceWithStreamingResponse(self._integrations.google_calendar)
@@ -153,6 +386,16 @@ class AsyncIntegrationsResourceWithStreamingResponse:
     def __init__(self, integrations: AsyncIntegrationsResource) -> None:
         self._integrations = integrations
 
+        self.list = async_to_streamed_response_wrapper(
+            integrations.list,
+        )
+        self.connect = async_to_streamed_response_wrapper(
+            integrations.connect,
+        )
+        self.revoke = async_to_streamed_response_wrapper(
+            integrations.revoke,
+        )
+
     @cached_property
     def google_calendar(self) -> AsyncGoogleCalendarResourceWithStreamingResponse:
         return AsyncGoogleCalendarResourceWithStreamingResponse(self._integrations.google_calendar)
diff --git a/src/hyperspell/types/__init__.py b/src/hyperspell/types/__init__.py
@@ -17,7 +17,11 @@
 from .memory_delete_response import MemoryDeleteResponse as MemoryDeleteResponse
 from .memory_status_response import MemoryStatusResponse as MemoryStatusResponse
 from .auth_delete_user_response import AuthDeleteUserResponse as AuthDeleteUserResponse
+from .integration_list_response import IntegrationListResponse as IntegrationListResponse
+from .integration_connect_params import IntegrationConnectParams as IntegrationConnectParams
 from .evaluate_score_query_params import EvaluateScoreQueryParams as EvaluateScoreQueryParams
+from .integration_revoke_response import IntegrationRevokeResponse as IntegrationRevokeResponse
+from .integration_connect_response import IntegrationConnectResponse as IntegrationConnectResponse
 from .evaluate_score_query_response import EvaluateScoreQueryResponse as EvaluateScoreQueryResponse
 from .evaluate_score_highlight_params import EvaluateScoreHighlightParams as EvaluateScoreHighlightParams
 from .evaluate_score_highlight_response import EvaluateScoreHighlightResponse as EvaluateScoreHighlightResponse
diff --git a/src/hyperspell/types/integration_connect_params.py b/src/hyperspell/types/integration_connect_params.py
@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+__all__ = ["IntegrationConnectParams"]
+
+
+class IntegrationConnectParams(TypedDict, total=False):
+    redirect_url: Optional[str]
diff --git a/src/hyperspell/types/integration_connect_response.py b/src/hyperspell/types/integration_connect_response.py
@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from datetime import datetime
+
+from .._models import BaseModel
+
+__all__ = ["IntegrationConnectResponse"]
+
+
+class IntegrationConnectResponse(BaseModel):
+    expires_at: datetime
+
+    url: str
diff --git a/src/hyperspell/types/integration_list_response.py b/src/hyperspell/types/integration_list_response.py
diff --git a/src/hyperspell/types/integration_revoke_response.py b/src/hyperspell/types/integration_revoke_response.py
diff --git a/tests/api_resources/test_integrations.py b/tests/api_resources/test_integrations.py
