telnyx 3.5.0a0__py3-none-any.whl → 3.6.0__py3-none-any.whl

telnyx/resources/calls/calls.py

@@ -12,6 +12,7 @@ from ...types import (
     StreamBidirectionalMode,
     StreamBidirectionalCodec,
     StreamBidirectionalTargetLegs,
+    StreamBidirectionalSamplingRate,
     call_dial_params,
 )
 from .actions import (
@@ -43,6 +44,7 @@ from ...types.stream_bidirectional_mode import StreamBidirectionalMode
 from ...types.stream_bidirectional_codec import StreamBidirectionalCodec
 from ...types.call_retrieve_status_response import CallRetrieveStatusResponse
 from ...types.stream_bidirectional_target_legs import StreamBidirectionalTargetLegs
+from ...types.stream_bidirectional_sampling_rate import StreamBidirectionalSamplingRate
 from ...types.calls.transcription_start_request_param import TranscriptionStartRequestParam
 
 __all__ = ["CallsResource", "AsyncCallsResource"]
@@ -97,6 +99,7 @@ class CallsResource(SyncAPIResource):
         link_to: str | Omit = omit,
         media_encryption: Literal["disabled", "SRTP", "DTLS"] | Omit = omit,
         media_name: str | Omit = omit,
+        park_after_unbridge: str | Omit = omit,
         preferred_codecs: str | Omit = omit,
         record: Literal["record-from-answer"] | Omit = omit,
         record_channels: Literal["single", "dual"] | Omit = omit,
@@ -114,7 +117,7 @@ class CallsResource(SyncAPIResource):
         sound_modifications: SoundModificationsParam | Omit = omit,
         stream_bidirectional_codec: StreamBidirectionalCodec | Omit = omit,
         stream_bidirectional_mode: StreamBidirectionalMode | Omit = omit,
-        stream_bidirectional_sampling_rate: Literal[8000, 16000, 48000] | Omit = omit,
+        stream_bidirectional_sampling_rate: StreamBidirectionalSamplingRate | Omit = omit,
         stream_bidirectional_target_legs: StreamBidirectionalTargetLegs | Omit = omit,
         stream_codec: StreamCodec | Omit = omit,
         stream_establish_before_call_originate: bool | Omit = omit,
@@ -141,9 +144,7 @@ class CallsResource(SyncAPIResource):
         include a `call_leg_id` which can be used to correlate the command with
         subsequent webhooks.
 
-        **Expected Webhooks (see
-        [schema](https://developers.telnyx.com/api/call-control/dial-call#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `call.initiated`
         - `call.answered` or `call.hangup`
@@ -232,6 +233,10 @@ class CallsResource(SyncAPIResource):
               api.telnyx.com/v2/media by the same user/organization. The file must either be a
               WAV or MP3 file.
 
+          park_after_unbridge: If supplied with the value `self`, the current leg will be parked after
+              unbridge. If not set, the default behavior is to hang up the leg. When
+              park_after_unbridge is set, link_to becomes required.
+
           preferred_codecs: The list of comma-separated codecs in a preferred order for the forked media to
               be received.
 
@@ -286,7 +291,6 @@ class CallsResource(SyncAPIResource):
 
           stream_codec: Specifies the codec to be used for the streamed audio. When set to 'default' or
               when transcoding is not possible, the codec from the call will be used.
-              Currently, transcoding is only supported between PCMU and PCMA codecs.
 
           stream_establish_before_call_originate: Establish websocket connection before dialing the destination. This is useful
               for cases where the websocket connection takes a long time to establish.
@@ -354,6 +358,7 @@ class CallsResource(SyncAPIResource):
                     "link_to": link_to,
                     "media_encryption": media_encryption,
                     "media_name": media_name,
+                    "park_after_unbridge": park_after_unbridge,
                     "preferred_codecs": preferred_codecs,
                     "record": record,
                     "record_channels": record_channels,
@@ -477,6 +482,7 @@ class AsyncCallsResource(AsyncAPIResource):
         link_to: str | Omit = omit,
         media_encryption: Literal["disabled", "SRTP", "DTLS"] | Omit = omit,
         media_name: str | Omit = omit,
+        park_after_unbridge: str | Omit = omit,
         preferred_codecs: str | Omit = omit,
         record: Literal["record-from-answer"] | Omit = omit,
         record_channels: Literal["single", "dual"] | Omit = omit,
@@ -494,7 +500,7 @@ class AsyncCallsResource(AsyncAPIResource):
         sound_modifications: SoundModificationsParam | Omit = omit,
         stream_bidirectional_codec: StreamBidirectionalCodec | Omit = omit,
         stream_bidirectional_mode: StreamBidirectionalMode | Omit = omit,
-        stream_bidirectional_sampling_rate: Literal[8000, 16000, 48000] | Omit = omit,
+        stream_bidirectional_sampling_rate: StreamBidirectionalSamplingRate | Omit = omit,
         stream_bidirectional_target_legs: StreamBidirectionalTargetLegs | Omit = omit,
         stream_codec: StreamCodec | Omit = omit,
         stream_establish_before_call_originate: bool | Omit = omit,
@@ -521,9 +527,7 @@ class AsyncCallsResource(AsyncAPIResource):
         include a `call_leg_id` which can be used to correlate the command with
         subsequent webhooks.
 
-        **Expected Webhooks (see
-        [schema](https://developers.telnyx.com/api/call-control/dial-call#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `call.initiated`
         - `call.answered` or `call.hangup`
@@ -612,6 +616,10 @@ class AsyncCallsResource(AsyncAPIResource):
               api.telnyx.com/v2/media by the same user/organization. The file must either be a
               WAV or MP3 file.
 
+          park_after_unbridge: If supplied with the value `self`, the current leg will be parked after
+              unbridge. If not set, the default behavior is to hang up the leg. When
+              park_after_unbridge is set, link_to becomes required.
+
           preferred_codecs: The list of comma-separated codecs in a preferred order for the forked media to
               be received.
 
@@ -666,7 +674,6 @@ class AsyncCallsResource(AsyncAPIResource):
 
           stream_codec: Specifies the codec to be used for the streamed audio. When set to 'default' or
               when transcoding is not possible, the codec from the call will be used.
-              Currently, transcoding is only supported between PCMU and PCMA codecs.
 
           stream_establish_before_call_originate: Establish websocket connection before dialing the destination. This is useful
               for cases where the websocket connection takes a long time to establish.
@@ -734,6 +741,7 @@ class AsyncCallsResource(AsyncAPIResource):
                     "link_to": link_to,
                     "media_encryption": media_encryption,
                     "media_name": media_name,
+                    "park_after_unbridge": park_after_unbridge,
                     "preferred_codecs": preferred_codecs,
                     "record": record,
                     "record_channels": record_channels,

telnyx/resources/conferences/actions.py

@@ -221,9 +221,7 @@ class ActionsResource(SyncAPIResource):
         certain amount of active participants, as set by the `max_participants`
         parameter in conference creation request.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/join-conference#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.participant.joined`
         - `conference.participant.left`
@@ -334,9 +332,7 @@ class ActionsResource(SyncAPIResource):
         """
         Removes a call leg from a conference and moves it back to parked state.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/leave-conference#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.participant.left`
 
@@ -589,9 +585,7 @@ class ActionsResource(SyncAPIResource):
         Recording will stop on conference end, or via
         the Stop Recording command.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/start-conference-recording#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.recording.saved`
 
@@ -655,9 +649,7 @@ class ActionsResource(SyncAPIResource):
         """
         Stop recording the conference.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/stop-conference-recording#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.recording.saved`
 
@@ -1109,9 +1101,7 @@ class AsyncActionsResource(AsyncAPIResource):
         certain amount of active participants, as set by the `max_participants`
         parameter in conference creation request.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/join-conference#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.participant.joined`
         - `conference.participant.left`
@@ -1222,9 +1212,7 @@ class AsyncActionsResource(AsyncAPIResource):
         """
         Removes a call leg from a conference and moves it back to parked state.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/leave-conference#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.participant.left`
 
@@ -1479,9 +1467,7 @@ class AsyncActionsResource(AsyncAPIResource):
         Recording will stop on conference end, or via
         the Stop Recording command.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/start-conference-recording#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.recording.saved`
 
@@ -1545,9 +1531,7 @@ class AsyncActionsResource(AsyncAPIResource):
         """
         Stop recording the conference.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/stop-conference-recording#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.recording.saved`
 

telnyx/resources/conferences/conferences.py

@@ -86,9 +86,7 @@ class ConferencesResource(SyncAPIResource):
         left the conference or after 4 hours regardless of the number of active
         participants.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/create-conference#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.created`
         - `conference.participant.joined`
@@ -360,9 +358,7 @@ class AsyncConferencesResource(AsyncAPIResource):
         left the conference or after 4 hours regardless of the number of active
         participants.
 
-        **Expected Webhooks (see
-        [callback schema](https://developers.telnyx.com/api/call-control/create-conference#callbacks)
-        below):**
+        **Expected Webhooks:**
 
         - `conference.created`
         - `conference.participant.joined`

telnyx/resources/documents.py

@@ -2,14 +2,14 @@
 
 from __future__ import annotations
 
-from typing import List, Union, Mapping, cast
+from typing import List, Union
 from typing_extensions import Literal, overload
 
 import httpx
 
-from ..types import document_list_params, document_update_params, document_upload_params
+from ..types import document_list_params, document_update_params, document_upload_params, document_upload_json_params
 from .._types import Body, Omit, Query, Headers, NotGiven, Base64FileInput, omit, not_given
-from .._utils import extract_files, required_args, maybe_transform, deepcopy_minimal, async_maybe_transform
+from .._utils import required_args, maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
@@ -32,6 +32,7 @@ from ..types.document_delete_response import DocumentDeleteResponse
 from ..types.document_update_response import DocumentUpdateResponse
 from ..types.document_upload_response import DocumentUploadResponse
 from ..types.document_retrieve_response import DocumentRetrieveResponse
+from ..types.document_upload_json_response import DocumentUploadJsonResponse
 from ..types.document_generate_download_link_response import DocumentGenerateDownloadLinkResponse
 
 __all__ = ["DocumentsResource", "AsyncDocumentsResource"]
@@ -380,30 +381,126 @@ class DocumentsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DocumentUploadResponse:
-        body = deepcopy_minimal(
-            {
-                "url": url,
-                "customer_reference": customer_reference,
-                "filename": filename,
-                "file": file,
-            }
-        )
-        files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
-        if files:
-            # It should be noted that the actual Content-Type header that will be
-            # sent to the server will contain a `boundary` parameter, e.g.
-            # multipart/form-data; boundary=---abc--
-            extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return self._post(
-            "/documents",
-            body=maybe_transform(body, document_upload_params.DocumentUploadParams),
-            files=files,
+            "/documents?content-type=multipart",
+            body=maybe_transform(
+                {
+                    "url": url,
+                    "customer_reference": customer_reference,
+                    "filename": filename,
+                    "file": file,
+                },
+                document_upload_params.DocumentUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=DocumentUploadResponse,
         )
 
+    @overload
+    def upload_json(
+        self,
+        *,
+        url: str,
+        customer_reference: str | Omit = omit,
+        filename: 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,
+    ) -> DocumentUploadJsonResponse:
+        """
+        Upload a document.<br /><br />Uploaded files must be linked to a service within
+        30 minutes or they will be automatically deleted.
+
+        Args:
+          url: If the file is already hosted publicly, you can provide a URL and have the
+              documents service fetch it for you.
+
+          customer_reference: Optional reference string for customer tracking.
+
+          filename: The filename of the document.
+
+          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
+        """
+        ...
+
+    @overload
+    def upload_json(
+        self,
+        *,
+        file: Union[str, Base64FileInput],
+        customer_reference: str | Omit = omit,
+        filename: 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,
+    ) -> DocumentUploadJsonResponse:
+        """
+        Upload a document.<br /><br />Uploaded files must be linked to a service within
+        30 minutes or they will be automatically deleted.
+
+        Args:
+          file: The Base64 encoded contents of the file you are uploading.
+
+          customer_reference: A customer reference string for customer look ups.
+
+          filename: The filename of the document.
+
+          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
+        """
+        ...
+
+    @required_args(["url"], ["file"])
+    def upload_json(
+        self,
+        *,
+        url: str | Omit = omit,
+        customer_reference: str | Omit = omit,
+        filename: str | Omit = omit,
+        file: Union[str, Base64FileInput] | 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,
+    ) -> DocumentUploadJsonResponse:
+        return self._post(
+            "/documents",
+            body=maybe_transform(
+                {
+                    "url": url,
+                    "customer_reference": customer_reference,
+                    "filename": filename,
+                    "file": file,
+                },
+                document_upload_json_params.DocumentUploadJsonParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DocumentUploadJsonResponse,
+        )
+
 
 class AsyncDocumentsResource(AsyncAPIResource):
     @cached_property
@@ -748,30 +845,126 @@ class AsyncDocumentsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> DocumentUploadResponse:
-        body = deepcopy_minimal(
-            {
-                "url": url,
-                "customer_reference": customer_reference,
-                "filename": filename,
-                "file": file,
-            }
-        )
-        files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
-        if files:
-            # It should be noted that the actual Content-Type header that will be
-            # sent to the server will contain a `boundary` parameter, e.g.
-            # multipart/form-data; boundary=---abc--
-            extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
         return await self._post(
-            "/documents",
-            body=await async_maybe_transform(body, document_upload_params.DocumentUploadParams),
-            files=files,
+            "/documents?content-type=multipart",
+            body=await async_maybe_transform(
+                {
+                    "url": url,
+                    "customer_reference": customer_reference,
+                    "filename": filename,
+                    "file": file,
+                },
+                document_upload_params.DocumentUploadParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=DocumentUploadResponse,
         )
 
+    @overload
+    async def upload_json(
+        self,
+        *,
+        url: str,
+        customer_reference: str | Omit = omit,
+        filename: 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,
+    ) -> DocumentUploadJsonResponse:
+        """
+        Upload a document.<br /><br />Uploaded files must be linked to a service within
+        30 minutes or they will be automatically deleted.
+
+        Args:
+          url: If the file is already hosted publicly, you can provide a URL and have the
+              documents service fetch it for you.
+
+          customer_reference: Optional reference string for customer tracking.
+
+          filename: The filename of the document.
+
+          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
+        """
+        ...
+
+    @overload
+    async def upload_json(
+        self,
+        *,
+        file: Union[str, Base64FileInput],
+        customer_reference: str | Omit = omit,
+        filename: 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,
+    ) -> DocumentUploadJsonResponse:
+        """
+        Upload a document.<br /><br />Uploaded files must be linked to a service within
+        30 minutes or they will be automatically deleted.
+
+        Args:
+          file: The Base64 encoded contents of the file you are uploading.
+
+          customer_reference: A customer reference string for customer look ups.
+
+          filename: The filename of the document.
+
+          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
+        """
+        ...
+
+    @required_args(["url"], ["file"])
+    async def upload_json(
+        self,
+        *,
+        url: str | Omit = omit,
+        customer_reference: str | Omit = omit,
+        filename: str | Omit = omit,
+        file: Union[str, Base64FileInput] | 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,
+    ) -> DocumentUploadJsonResponse:
+        return await self._post(
+            "/documents",
+            body=await async_maybe_transform(
+                {
+                    "url": url,
+                    "customer_reference": customer_reference,
+                    "filename": filename,
+                    "file": file,
+                },
+                document_upload_json_params.DocumentUploadJsonParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DocumentUploadJsonResponse,
+        )
+
 
 class DocumentsResourceWithRawResponse:
     def __init__(self, documents: DocumentsResource) -> None:
@@ -799,6 +992,9 @@ class DocumentsResourceWithRawResponse:
         self.upload = to_raw_response_wrapper(
             documents.upload,
         )
+        self.upload_json = to_raw_response_wrapper(
+            documents.upload_json,
+        )
 
 
 class AsyncDocumentsResourceWithRawResponse:
@@ -827,6 +1023,9 @@ class AsyncDocumentsResourceWithRawResponse:
         self.upload = async_to_raw_response_wrapper(
             documents.upload,
         )
+        self.upload_json = async_to_raw_response_wrapper(
+            documents.upload_json,
+        )
 
 
 class DocumentsResourceWithStreamingResponse:
@@ -855,6 +1054,9 @@ class DocumentsResourceWithStreamingResponse:
         self.upload = to_streamed_response_wrapper(
             documents.upload,
         )
+        self.upload_json = to_streamed_response_wrapper(
+            documents.upload_json,
+        )
 
 
 class AsyncDocumentsResourceWithStreamingResponse:
@@ -883,3 +1085,6 @@ class AsyncDocumentsResourceWithStreamingResponse:
         self.upload = async_to_streamed_response_wrapper(
             documents.upload,
         )
+        self.upload_json = async_to_streamed_response_wrapper(
+            documents.upload_json,
+        )

telnyx/resources/legacy/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .legacy import (
+    LegacyResource,
+    AsyncLegacyResource,
+    LegacyResourceWithRawResponse,
+    AsyncLegacyResourceWithRawResponse,
+    LegacyResourceWithStreamingResponse,
+    AsyncLegacyResourceWithStreamingResponse,
+)
+from .reporting import (
+    ReportingResource,
+    AsyncReportingResource,
+    ReportingResourceWithRawResponse,
+    AsyncReportingResourceWithRawResponse,
+    ReportingResourceWithStreamingResponse,
+    AsyncReportingResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "ReportingResource",
+    "AsyncReportingResource",
+    "ReportingResourceWithRawResponse",
+    "AsyncReportingResourceWithRawResponse",
+    "ReportingResourceWithStreamingResponse",
+    "AsyncReportingResourceWithStreamingResponse",
+    "LegacyResource",
+    "AsyncLegacyResource",
+    "LegacyResourceWithRawResponse",
+    "AsyncLegacyResourceWithRawResponse",
+    "LegacyResourceWithStreamingResponse",
+    "AsyncLegacyResourceWithStreamingResponse",
+]