telnyx 3.9.0__py3-none-any.whl → 3.11.0__py3-none-any.whl

telnyx/resources/conferences/conferences.py

@@ -6,7 +6,12 @@ from typing_extensions import Literal
 
 import httpx
 
-from ...types import conference_list_params, conference_create_params, conference_list_participants_params
+from ...types import (
+    conference_list_params,
+    conference_create_params,
+    conference_retrieve_params,
+    conference_list_participants_params,
+)
 from .actions import (
     ActionsResource,
     AsyncActionsResource,
@@ -71,6 +76,7 @@ class ConferencesResource(SyncAPIResource):
         hold_audio_url: str | Omit = omit,
         hold_media_name: str | Omit = omit,
         max_participants: int | Omit = omit,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
         start_conference_on_create: bool | 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.
@@ -129,6 +135,9 @@ class ConferencesResource(SyncAPIResource):
           max_participants: The maximum number of active conference participants to allow. Must be between 2
               and 800. Defaults to 250
 
+          region: Sets the region where the conference data will be hosted. Defaults to the region
+              defined in user's data locality settings (Europe or US).
+
           start_conference_on_create: Whether the conference should be started on creation. If the conference isn't
               started all participants that join are automatically put on hold. Defaults to
               "true".
@@ -155,6 +164,7 @@ class ConferencesResource(SyncAPIResource):
                     "hold_audio_url": hold_audio_url,
                     "hold_media_name": hold_media_name,
                     "max_participants": max_participants,
+                    "region": region,
                     "start_conference_on_create": start_conference_on_create,
                 },
                 conference_create_params.ConferenceCreateParams,
@@ -169,6 +179,7 @@ class ConferencesResource(SyncAPIResource):
         self,
         id: str,
         *,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | 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,
@@ -180,6 +191,8 @@ class ConferencesResource(SyncAPIResource):
         Retrieve an existing conference
 
         Args:
+          region: Region where the conference data is located
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -193,7 +206,11 @@ class ConferencesResource(SyncAPIResource):
         return self._get(
             f"/conferences/{id}",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"region": region}, conference_retrieve_params.ConferenceRetrieveParams),
             ),
             cast_to=ConferenceRetrieveResponse,
         )
@@ -203,6 +220,7 @@ class ConferencesResource(SyncAPIResource):
         *,
         filter: conference_list_params.Filter | Omit = omit,
         page: conference_list_params.Page | Omit = omit,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | 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,
@@ -228,6 +246,8 @@ class ConferencesResource(SyncAPIResource):
           page: Consolidated page parameter (deepObject style). Originally: page[after],
               page[before], page[limit], page[size], page[number]
 
+          region: Region where the conference data is located
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -247,6 +267,7 @@ class ConferencesResource(SyncAPIResource):
                     {
                         "filter": filter,
                         "page": page,
+                        "region": region,
                     },
                     conference_list_params.ConferenceListParams,
                 ),
@@ -260,6 +281,7 @@ class ConferencesResource(SyncAPIResource):
         *,
         filter: conference_list_participants_params.Filter | Omit = omit,
         page: conference_list_participants_params.Page | Omit = omit,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | 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,
@@ -277,6 +299,8 @@ class ConferencesResource(SyncAPIResource):
           page: Consolidated page parameter (deepObject style). Originally: page[after],
               page[before], page[limit], page[size], page[number]
 
+          region: Region where the conference data is located
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -298,6 +322,7 @@ class ConferencesResource(SyncAPIResource):
                     {
                         "filter": filter,
                         "page": page,
+                        "region": region,
                     },
                     conference_list_participants_params.ConferenceListParticipantsParams,
                 ),
@@ -343,6 +368,7 @@ class AsyncConferencesResource(AsyncAPIResource):
         hold_audio_url: str | Omit = omit,
         hold_media_name: str | Omit = omit,
         max_participants: int | Omit = omit,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | Omit = omit,
         start_conference_on_create: bool | 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.
@@ -401,6 +427,9 @@ class AsyncConferencesResource(AsyncAPIResource):
           max_participants: The maximum number of active conference participants to allow. Must be between 2
               and 800. Defaults to 250
 
+          region: Sets the region where the conference data will be hosted. Defaults to the region
+              defined in user's data locality settings (Europe or US).
+
           start_conference_on_create: Whether the conference should be started on creation. If the conference isn't
               started all participants that join are automatically put on hold. Defaults to
               "true".
@@ -427,6 +456,7 @@ class AsyncConferencesResource(AsyncAPIResource):
                     "hold_audio_url": hold_audio_url,
                     "hold_media_name": hold_media_name,
                     "max_participants": max_participants,
+                    "region": region,
                     "start_conference_on_create": start_conference_on_create,
                 },
                 conference_create_params.ConferenceCreateParams,
@@ -441,6 +471,7 @@ class AsyncConferencesResource(AsyncAPIResource):
         self,
         id: str,
         *,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | 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,
@@ -452,6 +483,8 @@ class AsyncConferencesResource(AsyncAPIResource):
         Retrieve an existing conference
 
         Args:
+          region: Region where the conference data is located
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -465,7 +498,13 @@ class AsyncConferencesResource(AsyncAPIResource):
         return await self._get(
             f"/conferences/{id}",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {"region": region}, conference_retrieve_params.ConferenceRetrieveParams
+                ),
             ),
             cast_to=ConferenceRetrieveResponse,
         )
@@ -475,6 +514,7 @@ class AsyncConferencesResource(AsyncAPIResource):
         *,
         filter: conference_list_params.Filter | Omit = omit,
         page: conference_list_params.Page | Omit = omit,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | 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,
@@ -500,6 +540,8 @@ class AsyncConferencesResource(AsyncAPIResource):
           page: Consolidated page parameter (deepObject style). Originally: page[after],
               page[before], page[limit], page[size], page[number]
 
+          region: Region where the conference data is located
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -519,6 +561,7 @@ class AsyncConferencesResource(AsyncAPIResource):
                     {
                         "filter": filter,
                         "page": page,
+                        "region": region,
                     },
                     conference_list_params.ConferenceListParams,
                 ),
@@ -532,6 +575,7 @@ class AsyncConferencesResource(AsyncAPIResource):
         *,
         filter: conference_list_participants_params.Filter | Omit = omit,
         page: conference_list_participants_params.Page | Omit = omit,
+        region: Literal["Australia", "Europe", "Middle East", "US"] | 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,
@@ -549,6 +593,8 @@ class AsyncConferencesResource(AsyncAPIResource):
           page: Consolidated page parameter (deepObject style). Originally: page[after],
               page[before], page[limit], page[size], page[number]
 
+          region: Region where the conference data is located
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -570,6 +616,7 @@ class AsyncConferencesResource(AsyncAPIResource):
                     {
                         "filter": filter,
                         "page": page,
+                        "region": region,
                     },
                     conference_list_participants_params.ConferenceListParticipantsParams,
                 ),

telnyx/resources/recordings/recordings.py

@@ -108,7 +108,7 @@ class RecordingsResource(SyncAPIResource):
               Consolidated filter parameter (deepObject style). Originally:
               filter[conference_id], filter[created_at][gte], filter[created_at][lte],
               filter[call_leg_id], filter[call_session_id], filter[from], filter[to],
-              filter[connection_id]
+              filter[connection_id], filter[sip_call_id]
 
           page: Consolidated page parameter (deepObject style). Originally: page[size],
               page[number]
@@ -250,7 +250,7 @@ class AsyncRecordingsResource(AsyncAPIResource):
               Consolidated filter parameter (deepObject style). Originally:
               filter[conference_id], filter[created_at][gte], filter[created_at][lte],
               filter[call_leg_id], filter[call_session_id], filter[from], filter[to],
-              filter[connection_id]
+              filter[connection_id], filter[sip_call_id]
 
           page: Consolidated page parameter (deepObject style). Originally: page[size],
               page[number]

telnyx/resources/texml/accounts/calls/calls.py

@@ -251,6 +251,7 @@ class CallsResource(SyncAPIResource):
         send_recording_url: bool | Omit = omit,
         sip_auth_password: str | Omit = omit,
         sip_auth_username: str | Omit = omit,
+        sip_region: Literal["US", "Europe", "Canada", "Australia", "Middle East"] | Omit = omit,
         status_callback: str | Omit = omit,
         status_callback_event: Literal["initiated", "ringing", "answered", "completed"] | Omit = omit,
         status_callback_method: Literal["GET", "POST"] | Omit = omit,
@@ -344,6 +345,8 @@ class CallsResource(SyncAPIResource):
 
           sip_auth_username: The username to use for SIP authentication.
 
+          sip_region: Defines the SIP region to be used for the call.
+
           status_callback: URL destination for Telnyx to send status callback events to for the call.
 
           status_callback_event: The call events for which Telnyx should send a webhook. Multiple events can be
@@ -401,6 +404,7 @@ class CallsResource(SyncAPIResource):
                     "send_recording_url": send_recording_url,
                     "sip_auth_password": sip_auth_password,
                     "sip_auth_username": sip_auth_username,
+                    "sip_region": sip_region,
                     "status_callback": status_callback,
                     "status_callback_event": status_callback_event,
                     "status_callback_method": status_callback_method,
@@ -849,6 +853,7 @@ class AsyncCallsResource(AsyncAPIResource):
         send_recording_url: bool | Omit = omit,
         sip_auth_password: str | Omit = omit,
         sip_auth_username: str | Omit = omit,
+        sip_region: Literal["US", "Europe", "Canada", "Australia", "Middle East"] | Omit = omit,
         status_callback: str | Omit = omit,
         status_callback_event: Literal["initiated", "ringing", "answered", "completed"] | Omit = omit,
         status_callback_method: Literal["GET", "POST"] | Omit = omit,
@@ -942,6 +947,8 @@ class AsyncCallsResource(AsyncAPIResource):
 
           sip_auth_username: The username to use for SIP authentication.
 
+          sip_region: Defines the SIP region to be used for the call.
+
           status_callback: URL destination for Telnyx to send status callback events to for the call.
 
           status_callback_event: The call events for which Telnyx should send a webhook. Multiple events can be
@@ -999,6 +1006,7 @@ class AsyncCallsResource(AsyncAPIResource):
                     "send_recording_url": send_recording_url,
                     "sip_auth_password": sip_auth_password,
                     "sip_auth_username": sip_auth_username,
+                    "sip_region": sip_region,
                     "status_callback": status_callback,
                     "status_callback_event": status_callback_event,
                     "status_callback_method": status_callback_method,

telnyx/resources/webhooks.py

@@ -3,8 +3,9 @@
 from __future__ import annotations
 
 import json
+import time
+import base64
 from typing import Mapping, cast
-from datetime import datetime, timezone
 
 from .._models import construct_type
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -12,106 +13,97 @@ from .._exceptions import TelnyxError
 from ..types.unwrap_webhook_event import UnwrapWebhookEvent
 from ..types.unsafe_unwrap_webhook_event import UnsafeUnwrapWebhookEvent
 
-__all__ = ["WebhooksResource", "AsyncWebhooksResource", "TelnyxWebhook", "TelnyxWebhookVerificationError"]
+__all__ = ["WebhooksResource", "AsyncWebhooksResource", "TelnyxWebhookVerificationError"]
 
 
 class TelnyxWebhookVerificationError(TelnyxError):
-    """Raised when webhook verification fails."""
+    """Raised when webhook signature verification fails."""
     pass
 
 
-class TelnyxWebhook:
+def _get_header_case_insensitive(headers: dict[str, str], key: str) -> str | None:
+    """Get header value case-insensitively."""
+    key_lower = key.lower()
+    for header_key, header_value in headers.items():
+        if header_key.lower() == key_lower:
+            return header_value
+    return None
+
+
+def _verify_signature(payload: str, headers: dict[str, str], public_key: str | bytes) -> None:
     """
-    Telnyx webhook verification following the standardwebhooks pattern.
-    
-    This class provides ED25519 signature verification for Telnyx webhooks
-    using the same interface pattern as the standardwebhooks library.
+    Verify Telnyx webhook signature using ED25519 cryptography.
+
+    Args:
+        payload: The raw webhook payload as a string
+        headers: The webhook headers
+        public_key: The ED25519 public key (base64 string from Mission Control)
+
+    Raises:
+        TelnyxWebhookVerificationError: If verification fails
     """
-    
-    def __init__(self, key: str | bytes):
-        """
-        Initialize the webhook verifier with a public key.
-        
-        Args:
-            key: The public key for verification (hex string or bytes)
-        """
-        try:
-            from nacl.signing import VerifyKey
-        except ImportError as exc:
-            raise TelnyxError("You need to install `pynacl` to verify Telnyx webhooks") from exc
-        
-        # Convert key to bytes if it's a string
-        if isinstance(key, str):
-            try:
-                key = bytes.fromhex(key)  # Convert from hex string to bytes
-            except ValueError as exc:
-                raise TelnyxWebhookVerificationError(f"Invalid key format: {key!r}") from exc
-        
-        self._verify_key = VerifyKey(key)
-    
-    def verify(self, payload: str, headers: Mapping[str, str]) -> None:
-        """
-        Verify a webhook payload and headers.
-        
-        Args:
-            payload: The webhook payload string
-            headers: The webhook headers
-            
-        Raises:
-            TelnyxWebhookVerificationError: If verification fails
-        """
-        try:
-            from nacl.exceptions import BadSignatureError
-        except ImportError as exc:
-            raise TelnyxError("You need to install `pynacl` to verify Telnyx webhooks") from exc
-        
-        # Extract required headers (case-insensitive lookup)
-        signature_header = headers.get("Telnyx-Signature-Ed25519") or headers.get("telnyx-signature-ed25519")
-        timestamp_header = headers.get("Telnyx-Timestamp") or headers.get("telnyx-timestamp")
-        user_agent = headers.get("User-Agent") or headers.get("user-agent", "")
-
-        # Validate required headers
-        if not signature_header:
-            raise TelnyxWebhookVerificationError("Missing required header: Telnyx-Signature-Ed25519")
-        
-        if not timestamp_header:
-            raise TelnyxWebhookVerificationError("Missing required header: Telnyx-Timestamp")
-
-        # Verify User-Agent if present (optional security check)
-        if user_agent and "telnyx-webhooks" not in user_agent.lower():
-            raise TelnyxWebhookVerificationError(f"Unexpected User-Agent: {user_agent}")
-
-        # Validate timestamp format and prevent replay attacks
-        try:
-            webhook_time = int(timestamp_header)
-            current_time = int(datetime.now(timezone.utc).timestamp())
-            
-            # Allow 5 minutes tolerance
-            if abs(current_time - webhook_time) > 300:
-                raise TelnyxWebhookVerificationError(
-                    f"Webhook timestamp too old or too new: {timestamp_header}"
-                )
-        except ValueError as exc:
+    try:
+        from nacl.signing import VerifyKey
+        from nacl.exceptions import BadSignatureError
+    except ImportError as exc:
+        raise TelnyxError("You need to install `pynacl` to use webhook verification") from exc
+
+    # Extract required headers (case-insensitive)
+    signature_header = _get_header_case_insensitive(headers, 'telnyx-signature-ed25519')
+    timestamp_header = _get_header_case_insensitive(headers, 'telnyx-timestamp')
+
+    if not signature_header:
+        raise TelnyxWebhookVerificationError("Missing header: Telnyx-Signature-Ed25519")
+
+    if not timestamp_header:
+        raise TelnyxWebhookVerificationError("Missing header: Telnyx-Timestamp")
+
+    # Validate timestamp to prevent replay attacks (5 minute tolerance)
+    try:
+        webhook_time = int(timestamp_header)
+        current_time = int(time.time())
+        if abs(current_time - webhook_time) > 300:  # 5 minutes
+            raise TelnyxWebhookVerificationError(f"Webhook timestamp too old or too new: {timestamp_header}")
+    except ValueError as exc:
+        raise TelnyxWebhookVerificationError(f"Invalid timestamp format: {timestamp_header}") from exc
+
+    # Decode public key from base64 (Telnyx provides keys in base64 format)
+    try:
+        if isinstance(public_key, str):
+            public_key_bytes = base64.b64decode(public_key)
+        else:
+            public_key_bytes = public_key
+
+        if len(public_key_bytes) != 32:
             raise TelnyxWebhookVerificationError(
-                f"Invalid timestamp format: {timestamp_header}"
-            ) from exc
+                f"Invalid public key: expected 32 bytes, got {len(public_key_bytes)} bytes"
+            )
+
+        verify_key = VerifyKey(public_key_bytes)
+    except Exception as exc:
+        raise TelnyxWebhookVerificationError(f"Invalid public key format: {exc}") from exc
+
+    # Decode signature from base64 (Telnyx sends signatures in base64 format)
+    try:
+        signature_bytes = base64.b64decode(signature_header)
 
-        # Decode the signature from hex
-        try:
-            signature = bytes.fromhex(signature_header)
-        except ValueError as exc:
+        if len(signature_bytes) != 64:
             raise TelnyxWebhookVerificationError(
-                f"Invalid signature format: {signature_header}"
-            ) from exc
+                f"Invalid signature length: expected 64 bytes, got {len(signature_bytes)} bytes"
+            )
+    except Exception as exc:
+        raise TelnyxWebhookVerificationError(f"Invalid signature format: {exc}") from exc
 
-        # Create the signed payload: timestamp + payload
-        signed_payload = timestamp_header.encode('utf-8') + payload.encode('utf-8')
+    # Create the signed payload: timestamp|payload
+    signed_payload = f"{timestamp_header}|{payload}".encode('utf-8')
 
-        # Verify the signature
-        try:
-            self._verify_key.verify(signed_payload, signature)
-        except BadSignatureError as exc:
-            raise TelnyxWebhookVerificationError("Invalid webhook signature") from exc
+    # Verify the signature
+    try:
+        verify_key.verify(signed_payload, signature_bytes)
+    except BadSignatureError as exc:
+        raise TelnyxWebhookVerificationError(
+            "Signature verification failed: signature does not match payload"
+        ) from exc
 
 
 class WebhooksResource(SyncAPIResource):
@@ -135,9 +127,7 @@ class WebhooksResource(SyncAPIResource):
         if not isinstance(headers, dict):
             headers = dict(headers)
 
-        # Use Telnyx-specific webhook verification following standardwebhooks pattern
-        webhook = TelnyxWebhook(key)
-        webhook.verify(payload, headers)
+        _verify_signature(payload, headers, key)
 
         return cast(
             UnwrapWebhookEvent,
@@ -169,9 +159,7 @@ class AsyncWebhooksResource(AsyncAPIResource):
         if not isinstance(headers, dict):
             headers = dict(headers)
 
-        # Use Telnyx-specific webhook verification following standardwebhooks pattern
-        webhook = TelnyxWebhook(key)
-        webhook.verify(payload, headers)
+        _verify_signature(payload, headers, key)
 
         return cast(
             UnwrapWebhookEvent,

telnyx/types/__init__.py

@@ -322,6 +322,7 @@ from .call_bridged_webhook_event import CallBridgedWebhookEvent as CallBridgedWe
 from .channel_zone_list_response import ChannelZoneListResponse as ChannelZoneListResponse
 from .channel_zone_update_params import ChannelZoneUpdateParams as ChannelZoneUpdateParams
 from .conference_create_response import ConferenceCreateResponse as ConferenceCreateResponse
+from .conference_retrieve_params import ConferenceRetrieveParams as ConferenceRetrieveParams
 from .document_retrieve_response import DocumentRetrieveResponse as DocumentRetrieveResponse
 from .dynamic_emergency_endpoint import DynamicEmergencyEndpoint as DynamicEmergencyEndpoint
 from .global_ip_assignment_param import GlobalIPAssignmentParam as GlobalIPAssignmentParam

telnyx/types/ai/__init__.py

@@ -35,6 +35,7 @@ from .embedding_list_params import EmbeddingListParams as EmbeddingListParams
 from .background_task_status import BackgroundTaskStatus as BackgroundTaskStatus
 from .cluster_compute_params import ClusterComputeParams as ClusterComputeParams
 from .insight_settings_param import InsightSettingsParam as InsightSettingsParam
+from .mcp_server_list_params import McpServerListParams as McpServerListParams
 from .privacy_settings_param import PrivacySettingsParam as PrivacySettingsParam
 from .transcription_settings import TranscriptionSettings as TranscriptionSettings
 from .assistant_chat_response import AssistantChatResponse as AssistantChatResponse
@@ -48,21 +49,29 @@ from .embedding_list_response import EmbeddingListResponse as EmbeddingListRespo
 from .cluster_compute_response import ClusterComputeResponse as ClusterComputeResponse
 from .conversation_list_params import ConversationListParams as ConversationListParams
 from .hangup_tool_params_param import HangupToolParamsParam as HangupToolParamsParam
+from .mcp_server_create_params import McpServerCreateParams as McpServerCreateParams
+from .mcp_server_list_response import McpServerListResponse as McpServerListResponse
+from .mcp_server_update_params import McpServerUpdateParams as McpServerUpdateParams
 from .messaging_settings_param import MessagingSettingsParam as MessagingSettingsParam
 from .telephony_settings_param import TelephonySettingsParam as TelephonySettingsParam
 from .assistant_delete_response import AssistantDeleteResponse as AssistantDeleteResponse
 from .assistant_retrieve_params import AssistantRetrieveParams as AssistantRetrieveParams
 from .audio_transcribe_response import AudioTranscribeResponse as AudioTranscribeResponse
 from .cluster_retrieve_response import ClusterRetrieveResponse as ClusterRetrieveResponse
+from .integration_list_response import IntegrationListResponse as IntegrationListResponse
 from .cluster_fetch_graph_params import ClusterFetchGraphParams as ClusterFetchGraphParams
 from .conversation_create_params import ConversationCreateParams as ConversationCreateParams
 from .conversation_list_response import ConversationListResponse as ConversationListResponse
 from .conversation_update_params import ConversationUpdateParams as ConversationUpdateParams
+from .mcp_server_create_response import McpServerCreateResponse as McpServerCreateResponse
+from .mcp_server_update_response import McpServerUpdateResponse as McpServerUpdateResponse
 from .embedding_retrieve_response import EmbeddingRetrieveResponse as EmbeddingRetrieveResponse
 from .assistant_get_texml_response import AssistantGetTexmlResponse as AssistantGetTexmlResponse
 from .conversation_update_response import ConversationUpdateResponse as ConversationUpdateResponse
+from .mcp_server_retrieve_response import McpServerRetrieveResponse as McpServerRetrieveResponse
 from .transcription_settings_param import TranscriptionSettingsParam as TranscriptionSettingsParam
 from .chat_create_completion_params import ChatCreateCompletionParams as ChatCreateCompletionParams
+from .integration_retrieve_response import IntegrationRetrieveResponse as IntegrationRetrieveResponse
 from .conversation_retrieve_response import ConversationRetrieveResponse as ConversationRetrieveResponse
 from .inference_embedding_bucket_ids import InferenceEmbeddingBucketIDs as InferenceEmbeddingBucketIDs
 from .conversation_add_message_params import ConversationAddMessageParams as ConversationAddMessageParams

telnyx/types/ai/integration_list_response.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["IntegrationListResponse", "Data"]
+
+
+class Data(BaseModel):
+    id: str
+
+    available_tools: List[str]
+
+    description: str
+
+    display_name: str
+
+    logo_url: str
+
+    name: str
+
+    status: Literal["disconnected", "connected"]
+
+
+class IntegrationListResponse(BaseModel):
+    data: List[Data]

telnyx/types/ai/integration_retrieve_response.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["IntegrationRetrieveResponse"]
+
+
+class IntegrationRetrieveResponse(BaseModel):
+    id: str
+
+    available_tools: List[str]
+
+    description: str
+
+    display_name: str
+
+    logo_url: str
+
+    name: str
+
+    status: Literal["disconnected", "connected"]

telnyx/types/ai/integrations/__init__.py

@@ -0,0 +1,6 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .connection_list_response import ConnectionListResponse as ConnectionListResponse
+from .connection_retrieve_response import ConnectionRetrieveResponse as ConnectionRetrieveResponse

telnyx/types/ai/integrations/connection_list_response.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from ...._models import BaseModel
+
+__all__ = ["ConnectionListResponse", "Data"]
+
+
+class Data(BaseModel):
+    id: str
+
+    allowed_tools: List[str]
+
+    integration_id: str
+
+
+class ConnectionListResponse(BaseModel):
+    data: List[Data]

telnyx/types/ai/integrations/connection_retrieve_response.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from ...._models import BaseModel
+
+__all__ = ["ConnectionRetrieveResponse", "Data"]
+
+
+class Data(BaseModel):
+    id: str
+
+    allowed_tools: List[str]
+
+    integration_id: str
+
+
+class ConnectionRetrieveResponse(BaseModel):
+    data: Data