feat: add aiohttp transport support via optional extra

The SDK now supports aiohttp as an alternative async HTTP transport backend.
When the `aiohttp` optional extra is installed (`pip install vapi_server_sdk[aiohttp]`),
the `AsyncVapi` client will automatically use `httpx-aiohttp` as its underlying
transport. Users who prefer the standard httpx client are unaffected — behaviour
is unchanged unless the extra is explicitly installed.

Key changes:
- Add new `aiohttp` optional extra (`aiohttp>=3.10,<4` + `httpx-aiohttp==0.1.8`)
- Introduce `DefaultAioHttpClient` and `DefaultAsyncHttpxClient` convenience classes (exported from top-level `vapi` package)
- Add `_make_default_async_client()` helper that auto-detects and prefers `httpx-aiohttp` when available
- Add pytest marker and conftest fixture to skip aiohttp tests when the extra is not installed

🌿 Generated with Fern

Author: fern-api[bot]

.fern/metadata.json

@@ -1,13 +1,13 @@
 {
-  "cliVersion": "4.62.4",
+  "cliVersion": "4.65.1",
   "generatorName": "fernapi/fern-python-sdk",
-  "generatorVersion": "5.2.0",
+  "generatorVersion": "5.3.3",
   "generatorConfig": {
     "pydantic_config": {
       "skip_validation": true
     },
     "client_class_name": "Vapi"
   },
-  "originGitCommit": "609e140e6338ba929ae7f23a23046ea7dc777b07",
-  "sdkVersion": "1.9.1"
+  "originGitCommit": "46b109d88752307f8952db91eaa642f61c3875b4",
+  "sdkVersion": "1.10.0"
 }

.github/workflows/ci.yml

@@ -40,6 +40,12 @@ jobs:
       - name: Test
         run: poetry run pytest -rP -n auto .
 
+      - name: Install aiohttp extra
+        run: poetry install --extras aiohttp
+
+      - name: Test (aiohttp)
+        run: poetry run pytest -rP -n auto -m aiohttp .
+
   publish:
     needs: [compile, test]
     if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')

changelog.md

@@ -1,3 +1,6 @@
+## 1.10.0 - 2026-04-10
+* The SDK now supports `aiohttp` as an optional async HTTP transport backend. Install the new extra (`pip install vapi_server_sdk[aiohttp]`) to have `AsyncVapi` automatically use `httpx-aiohttp` under the hood. Two new convenience classes, `DefaultAioHttpClient` and `DefaultAsyncHttpxClient`, are also now available for users who want to configure the async HTTP client explicitly.
+
 ## 1.9.1 - 2026-04-07
 * SDK regeneration
 * Unable to analyze changes with AI, incrementing PATCH version.

poetry.lock

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "vapi_server_sdk"
-version = "1.9.1"
+version = "1.10.0"
 description = ""
 readme = "README.md"
 authors = []
@@ -37,7 +37,9 @@ Repository = 'https://github.com/VapiAI/server-sdk-python'
 
 [tool.poetry.dependencies]
 python = "^3.10"
+aiohttp = { version = ">=3.10.0,<4", optional = true}
 httpx = ">=0.21.2"
+httpx-aiohttp = { version = "0.1.8", optional = true}
 pydantic = ">= 1.9.2"
 pydantic-core = ">=2.18.2,<2.44.0"
 typing_extensions = ">= 4.0.0"
@@ -54,6 +56,9 @@ ruff = "==0.11.5"
 [tool.pytest.ini_options]
 testpaths = [ "tests" ]
 asyncio_mode = "auto"
+markers = [
+    "aiohttp: tests that require httpx_aiohttp to be installed",
+]
 
 [tool.mypy]
 plugins = ["pydantic.mypy"]
@@ -85,3 +90,6 @@ section-order = ["future", "standard-library", "third-party", "first-party"]
 [build-system]
 requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.extras]
+aiohttp=["aiohttp", "httpx-aiohttp"]

pyproject.toml

@@ -3646,17 +3646,17 @@ client.phone_numbers.list()
 ```python
 from vapi import Vapi
 from vapi.environment import VapiEnvironment
+from vapi.phone_numbers import CreatePhoneNumbersRequest_ByoPhoneNumber
 
 client = Vapi(
     token="<token>",
     environment=VapiEnvironment.DEFAULT,
 )
 
 client.phone_numbers.create(
-    request={
-        "provider": "byo-phone-number",
-        "credential_id": "credentialId"
-    },
+    request=CreatePhoneNumbersRequest_ByoPhoneNumber(
+        credential_id="credentialId",
+    ),
 )
 
 ```
@@ -3971,6 +3971,7 @@ client.phone_numbers.delete(
 ```python
 from vapi import Vapi
 from vapi.environment import VapiEnvironment
+from vapi.phone_numbers import UpdatePhoneNumbersRequestBody_ByoPhoneNumber
 
 client = Vapi(
     token="<token>",
@@ -3979,9 +3980,7 @@ client = Vapi(
 
 client.phone_numbers.update(
     id="id",
-    request={
-        "provider": "byo-phone-number"
-    },
+    request=UpdatePhoneNumbersRequestBody_ByoPhoneNumber(),
 )
 
 ```
@@ -4163,18 +4162,18 @@ client.tools.list()
 ```python
 from vapi import Vapi
 from vapi.environment import VapiEnvironment
+from vapi.tools import CreateToolsRequest_ApiRequest
 
 client = Vapi(
     token="<token>",
     environment=VapiEnvironment.DEFAULT,
 )
 
 client.tools.create(
-    request={
-        "type": "apiRequest",
-        "method": "POST",
-        "url": "url"
-    },
+    request=CreateToolsRequest_ApiRequest(
+        method="POST",
+        url="url",
+    ),
 )
 
 ```
@@ -4344,6 +4343,7 @@ client.tools.delete(
 ```python
 from vapi import Vapi
 from vapi.environment import VapiEnvironment
+from vapi.tools import UpdateToolsRequestBody_ApiRequest
 
 client = Vapi(
     token="<token>",
@@ -4352,9 +4352,7 @@ client = Vapi(
 
 client.tools.update(
     id="id",
-    request={
-        "type": "apiRequest"
-    },
+    request=UpdateToolsRequestBody_ApiRequest(),
 )
 
 ```
@@ -5477,24 +5475,24 @@ client.insight.insight_controller_find_all()
 ```python
 from vapi import Vapi, JsonQueryOnCallTableWithStringTypeColumn
 from vapi.environment import VapiEnvironment
+from vapi.insight import InsightControllerCreateRequest_Bar
 
 client = Vapi(
     token="<token>",
     environment=VapiEnvironment.DEFAULT,
 )
 
 client.insight.insight_controller_create(
-    request={
-        "type": "bar",
-        "queries": [
+    request=InsightControllerCreateRequest_Bar(
+        queries=[
             JsonQueryOnCallTableWithStringTypeColumn(
                 type="vapiql-json",
                 table="call",
                 column="id",
                 operation="count",
             )
-        ]
-    },
+        ],
+    ),
 )
 
 ```
@@ -5664,6 +5662,7 @@ client.insight.insight_controller_remove(
 ```python
 from vapi import Vapi
 from vapi.environment import VapiEnvironment
+from vapi.insight import InsightControllerUpdateRequestBody_Bar
 
 client = Vapi(
     token="<token>",
@@ -5672,9 +5671,7 @@ client = Vapi(
 
 client.insight.insight_controller_update(
     id="id",
-    request={
-        "type": "bar"
-    },
+    request=InsightControllerUpdateRequestBody_Bar(),
 )
 
 ```
@@ -5817,24 +5814,24 @@ For Pie and Text Insights, step will be ignored even if provided.
 ```python
 from vapi import Vapi, JsonQueryOnCallTableWithStringTypeColumn
 from vapi.environment import VapiEnvironment
+from vapi.insight import InsightControllerPreviewRequest_Bar
 
 client = Vapi(
     token="<token>",
     environment=VapiEnvironment.DEFAULT,
 )
 
 client.insight.insight_controller_preview(
-    request={
-        "type": "bar",
-        "queries": [
+    request=InsightControllerPreviewRequest_Bar(
+        queries=[
             JsonQueryOnCallTableWithStringTypeColumn(
                 type="vapiql-json",
                 table="call",
                 column="id",
                 operation="count",
             )
-        ]
-    },
+        ],
+    ),
 )
 
 ```
@@ -6583,16 +6580,15 @@ client.eval.eval_controller_get_runs_paginated()
 ```python
 from vapi import Vapi
 from vapi.environment import VapiEnvironment
+from vapi.eval import CreateEvalRunDtoTarget_Assistant
 
 client = Vapi(
     token="<token>",
     environment=VapiEnvironment.DEFAULT,
 )
 
 client.eval.eval_controller_run(
-    target={
-        "type": "assistant"
-    },
+    target=CreateEvalRunDtoTarget_Assistant(),
     type="eval",
 )
 

reference.md

@@ -4212,6 +4212,7 @@
         structured_outputs,
         tools,
     )
+    from ._default_clients import DefaultAioHttpClient, DefaultAsyncHttpxClient
     from .assistants import (
         UpdateAssistantDtoBackgroundSound,
         UpdateAssistantDtoBackgroundSoundZero,
@@ -6349,6 +6350,8 @@
     "DeepgramVoice": ".types",
     "DeepgramVoiceId": ".types",
     "DeepgramVoiceModel": ".types",
+    "DefaultAioHttpClient": "._default_clients",
+    "DefaultAsyncHttpxClient": "._default_clients",
     "DeletePhoneNumbersResponse": ".phone_numbers",
     "DeletePhoneNumbersResponse_ByoPhoneNumber": ".phone_numbers",
     "DeletePhoneNumbersResponse_Telnyx": ".phone_numbers",
@@ -10984,6 +10987,8 @@ def __dir__():
     "DeepgramVoice",
     "DeepgramVoiceId",
     "DeepgramVoiceModel",
+    "DefaultAioHttpClient",
+    "DefaultAsyncHttpxClient",
     "DeletePhoneNumbersResponse",
     "DeletePhoneNumbersResponse_ByoPhoneNumber",
     "DeletePhoneNumbersResponse_Telnyx",

src/vapi/__init__.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import httpx
+
+SDK_DEFAULT_TIMEOUT = 60
+
+try:
+    import httpx_aiohttp  # type: ignore[import-not-found]
+except ImportError:
+
+    class DefaultAioHttpClient(httpx.AsyncClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            raise RuntimeError(
+                "To use the aiohttp client, install the aiohttp extra: pip install vapi_server_sdk[aiohttp]"
+            )
+
+else:
+
+    class DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+            kwargs.setdefault("follow_redirects", True)
+            super().__init__(**kwargs)
+
+
+class DefaultAsyncHttpxClient(httpx.AsyncClient):
+    def __init__(self, **kwargs: typing.Any) -> None:
+        kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+        kwargs.setdefault("follow_redirects", True)
+        super().__init__(**kwargs)

src/vapi/_default_clients.py

@@ -234,6 +234,24 @@ def analytics(self):
         return self._analytics
 
 
+def _make_default_async_client(
+    timeout: typing.Optional[float],
+    follow_redirects: typing.Optional[bool],
+) -> httpx.AsyncClient:
+    try:
+        import httpx_aiohttp  # type: ignore[import-not-found]
+    except ImportError:
+        pass
+    else:
+        if follow_redirects is not None:
+            return httpx_aiohttp.HttpxAiohttpClient(timeout=timeout, follow_redirects=follow_redirects)
+        return httpx_aiohttp.HttpxAiohttpClient(timeout=timeout)
+
+    if follow_redirects is not None:
+        return httpx.AsyncClient(timeout=timeout, follow_redirects=follow_redirects)
+    return httpx.AsyncClient(timeout=timeout)
+
+
 class AsyncVapi:
     """
     Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
@@ -303,9 +321,7 @@ def __init__(
             async_token=async_token,
             httpx_client=httpx_client
             if httpx_client is not None
-            else httpx.AsyncClient(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
-            if follow_redirects is not None
-            else httpx.AsyncClient(timeout=_defaulted_timeout),
+            else _make_default_async_client(timeout=_defaulted_timeout, follow_redirects=follow_redirects),
             timeout=_defaulted_timeout,
             logging=logging,
         )

src/vapi/client.py

@@ -27,12 +27,12 @@ def get_headers(self) -> typing.Dict[str, str]:
         import platform
 
         headers: typing.Dict[str, str] = {
-            "User-Agent": "vapi_server_sdk/1.9.1",
+            "User-Agent": "vapi_server_sdk/1.10.0",
             "X-Fern-Language": "Python",
             "X-Fern-Runtime": f"python/{platform.python_version()}",
             "X-Fern-Platform": f"{platform.system().lower()}/{platform.release()}",
             "X-Fern-SDK-Name": "vapi_server_sdk",
-            "X-Fern-SDK-Version": "1.9.1",
+            "X-Fern-SDK-Version": "1.10.0",
             **(self.get_custom_headers() or {}),
         }
         headers["Authorization"] = f"Bearer {self._get_token()}"