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

telnyx/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "telnyx"
-__version__ = "3.5.0"  # x-release-please-version
+__version__ = "3.6.0"  # x-release-please-version

telnyx/resources/ai/assistants/assistants.py

@@ -67,17 +67,15 @@ from .scheduled_events import (
 )
 from ....types.ai.assistants_list import AssistantsList
 from ....types.ai.enabled_features import EnabledFeatures
+from ....types.ai.inference_embedding import InferenceEmbedding
 from ....types.ai.assistant_tool_param import AssistantToolParam
 from ....types.ai.voice_settings_param import VoiceSettingsParam
 from ....types.ai.insight_settings_param import InsightSettingsParam
 from ....types.ai.privacy_settings_param import PrivacySettingsParam
 from ....types.ai.assistant_chat_response import AssistantChatResponse
-from ....types.ai.assistant_clone_response import AssistantCloneResponse
 from ....types.ai.messaging_settings_param import MessagingSettingsParam
 from ....types.ai.telephony_settings_param import TelephonySettingsParam
-from ....types.ai.assistant_create_response import AssistantCreateResponse
 from ....types.ai.assistant_delete_response import AssistantDeleteResponse
-from ....types.ai.assistant_retrieve_response import AssistantRetrieveResponse
 from ....types.ai.transcription_settings_param import TranscriptionSettingsParam
 
 __all__ = ["AssistantsResource", "AsyncAssistantsResource"]
@@ -148,7 +146,7 @@ class AssistantsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AssistantCreateResponse:
+    ) -> InferenceEmbedding:
         """
         Create a new AI Assistant.
 
@@ -214,7 +212,7 @@ class AssistantsResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=AssistantCreateResponse,
+            cast_to=InferenceEmbedding,
         )
 
     def retrieve(
@@ -231,7 +229,7 @@ class AssistantsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AssistantRetrieveResponse:
+    ) -> InferenceEmbedding:
         """
         Retrieve an AI Assistant configuration by `assistant_id`.
 
@@ -263,7 +261,7 @@ class AssistantsResource(SyncAPIResource):
                     assistant_retrieve_params.AssistantRetrieveParams,
                 ),
             ),
-            cast_to=AssistantRetrieveResponse,
+            cast_to=InferenceEmbedding,
         )
 
     def update(
@@ -487,7 +485,7 @@ class AssistantsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AssistantCloneResponse:
+    ) -> InferenceEmbedding:
         """
         Clone an existing assistant, excluding telephony and messaging settings.
 
@@ -507,7 +505,7 @@ class AssistantsResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=AssistantCloneResponse,
+            cast_to=InferenceEmbedding,
         )
 
     def get_texml(
@@ -657,7 +655,7 @@ class AsyncAssistantsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AssistantCreateResponse:
+    ) -> InferenceEmbedding:
         """
         Create a new AI Assistant.
 
@@ -723,7 +721,7 @@ class AsyncAssistantsResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=AssistantCreateResponse,
+            cast_to=InferenceEmbedding,
         )
 
     async def retrieve(
@@ -740,7 +738,7 @@ class AsyncAssistantsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AssistantRetrieveResponse:
+    ) -> InferenceEmbedding:
         """
         Retrieve an AI Assistant configuration by `assistant_id`.
 
@@ -772,7 +770,7 @@ class AsyncAssistantsResource(AsyncAPIResource):
                     assistant_retrieve_params.AssistantRetrieveParams,
                 ),
             ),
-            cast_to=AssistantRetrieveResponse,
+            cast_to=InferenceEmbedding,
         )
 
     async def update(
@@ -996,7 +994,7 @@ class AsyncAssistantsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AssistantCloneResponse:
+    ) -> InferenceEmbedding:
         """
         Clone an existing assistant, excluding telephony and messaging settings.
 
@@ -1016,7 +1014,7 @@ class AsyncAssistantsResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=AssistantCloneResponse,
+            cast_to=InferenceEmbedding,
         )
 
     async def get_texml(

telnyx/resources/ai/assistants/versions.py

@@ -20,6 +20,7 @@ from ...._base_client import make_request_options
 from ....types.ai.assistants import version_update_params, version_retrieve_params
 from ....types.ai.assistants_list import AssistantsList
 from ....types.ai.enabled_features import EnabledFeatures
+from ....types.ai.inference_embedding import InferenceEmbedding
 from ....types.ai.assistant_tool_param import AssistantToolParam
 from ....types.ai.voice_settings_param import VoiceSettingsParam
 from ....types.ai.insight_settings_param import InsightSettingsParam
@@ -27,9 +28,6 @@ from ....types.ai.privacy_settings_param import PrivacySettingsParam
 from ....types.ai.messaging_settings_param import MessagingSettingsParam
 from ....types.ai.telephony_settings_param import TelephonySettingsParam
 from ....types.ai.transcription_settings_param import TranscriptionSettingsParam
-from ....types.ai.assistants.version_update_response import VersionUpdateResponse
-from ....types.ai.assistants.version_promote_response import VersionPromoteResponse
-from ....types.ai.assistants.version_retrieve_response import VersionRetrieveResponse
 
 __all__ = ["VersionsResource", "AsyncVersionsResource"]
 
@@ -66,7 +64,7 @@ class VersionsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VersionRetrieveResponse:
+    ) -> InferenceEmbedding:
         """
         Retrieves a specific version of an assistant by assistant_id and version_id
 
@@ -94,7 +92,7 @@ class VersionsResource(SyncAPIResource):
                     {"include_mcp_servers": include_mcp_servers}, version_retrieve_params.VersionRetrieveParams
                 ),
             ),
-            cast_to=VersionRetrieveResponse,
+            cast_to=InferenceEmbedding,
         )
 
     def update(
@@ -124,7 +122,7 @@ class VersionsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VersionUpdateResponse:
+    ) -> InferenceEmbedding:
         """Updates the configuration of a specific assistant version.
 
         Can not update main
@@ -196,7 +194,7 @@ class VersionsResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VersionUpdateResponse,
+            cast_to=InferenceEmbedding,
         )
 
     def list(
@@ -283,7 +281,7 @@ class VersionsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VersionPromoteResponse:
+    ) -> InferenceEmbedding:
         """
         Promotes a specific version to be the main/current version of the assistant.
         This will delete any existing canary deploy configuration and send all live
@@ -307,7 +305,7 @@ class VersionsResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VersionPromoteResponse,
+            cast_to=InferenceEmbedding,
         )
 
 
@@ -343,7 +341,7 @@ class AsyncVersionsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VersionRetrieveResponse:
+    ) -> InferenceEmbedding:
         """
         Retrieves a specific version of an assistant by assistant_id and version_id
 
@@ -371,7 +369,7 @@ class AsyncVersionsResource(AsyncAPIResource):
                     {"include_mcp_servers": include_mcp_servers}, version_retrieve_params.VersionRetrieveParams
                 ),
             ),
-            cast_to=VersionRetrieveResponse,
+            cast_to=InferenceEmbedding,
         )
 
     async def update(
@@ -401,7 +399,7 @@ class AsyncVersionsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VersionUpdateResponse:
+    ) -> InferenceEmbedding:
         """Updates the configuration of a specific assistant version.
 
         Can not update main
@@ -473,7 +471,7 @@ class AsyncVersionsResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VersionUpdateResponse,
+            cast_to=InferenceEmbedding,
         )
 
     async def list(
@@ -560,7 +558,7 @@ class AsyncVersionsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VersionPromoteResponse:
+    ) -> InferenceEmbedding:
         """
         Promotes a specific version to be the main/current version of the assistant.
         This will delete any existing canary deploy configuration and send all live
@@ -584,7 +582,7 @@ class AsyncVersionsResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VersionPromoteResponse,
+            cast_to=InferenceEmbedding,
         )
 
 

telnyx/resources/calls/actions.py

@@ -12,6 +12,7 @@ from ...types import (
     StreamBidirectionalMode,
     StreamBidirectionalCodec,
     StreamBidirectionalTargetLegs,
+    StreamBidirectionalSamplingRate,
 )
 from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
@@ -90,6 +91,7 @@ from ...types.calls.action_stop_siprec_response import ActionStopSiprecResponse
 from ...types.calls.interruption_settings_param import InterruptionSettingsParam
 from ...types.calls.action_start_siprec_response import ActionStartSiprecResponse
 from ...types.calls.action_stop_forking_response import ActionStopForkingResponse
+from ...types.stream_bidirectional_sampling_rate import StreamBidirectionalSamplingRate
 from ...types.calls.action_send_sip_info_response import ActionSendSipInfoResponse
 from ...types.calls.action_start_forking_response import ActionStartForkingResponse
 from ...types.calls.action_stop_playback_response import ActionStopPlaybackResponse
@@ -2421,7 +2423,7 @@ class ActionsResource(SyncAPIResource):
         enable_dialogflow: bool | Omit = omit,
         stream_bidirectional_codec: StreamBidirectionalCodec | Omit = omit,
         stream_bidirectional_mode: StreamBidirectionalMode | Omit = omit,
-        stream_bidirectional_sampling_rate: Literal[8000, 16000, 22050, 24000, 48000] | Omit = omit,
+        stream_bidirectional_sampling_rate: StreamBidirectionalSamplingRate | Omit = omit,
         stream_bidirectional_target_legs: StreamBidirectionalTargetLegs | Omit = omit,
         stream_codec: StreamCodec | Omit = omit,
         stream_track: Literal["inbound_track", "outbound_track", "both_tracks"] | Omit = omit,
@@ -5664,7 +5666,7 @@ class AsyncActionsResource(AsyncAPIResource):
         enable_dialogflow: bool | Omit = omit,
         stream_bidirectional_codec: StreamBidirectionalCodec | Omit = omit,
         stream_bidirectional_mode: StreamBidirectionalMode | Omit = omit,
-        stream_bidirectional_sampling_rate: Literal[8000, 16000, 22050, 24000, 48000] | Omit = omit,
+        stream_bidirectional_sampling_rate: StreamBidirectionalSamplingRate | Omit = omit,
         stream_bidirectional_target_legs: StreamBidirectionalTargetLegs | Omit = omit,
         stream_codec: StreamCodec | Omit = omit,
         stream_track: Literal["inbound_track", "outbound_track", "both_tracks"] | Omit = omit,

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"]
@@ -115,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, 22050, 24000, 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,
@@ -498,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, 22050, 24000, 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,

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,
+        )