release: 3.2.0-alpha (#95)

* codegen metadata

* codegen metadata

* feat: port-4304: add public download document link specs

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* release: 3.2.0-alpha

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.1.0-alpha"
+  ".": "3.2.0-alpha"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 800
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx%2Ftelnyx-40a540682e7307b506c6d48ed7fc93b2751075b37276bbf6d1871415abc701a4.yml
-openapi_spec_hash: 2d2c92c05002d51217cb901152d4439a
-config_hash: 042e8a6e781fd484663a6c2142daaae5
+configured_endpoints: 801
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx%2Ftelnyx-f817dc5db29d722549a84a416041e8b986274237116593a3feeaefb1c5e93ed0.yml
+openapi_spec_hash: e344d1e9ae23ddd4cd7646113ee76e7f
+config_hash: 6bab75d5a002089c3f9b042706f8c4eb

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.2.0-alpha (2025-08-27)
+
+Full Changelog: [v3.1.0-alpha...v3.2.0-alpha](https://github.com/team-telnyx/telnyx-python/compare/v3.1.0-alpha...v3.2.0-alpha)
+
+### Features
+
+* port-4304: add public download document link specs ([c99efa8](https://github.com/team-telnyx/telnyx-python/commit/c99efa8fe272848ccdb18b984238b44f065dd0b2))
+
 ## 3.1.0-alpha (2025-08-27)
 
 Full Changelog: [v3.0.0-alpha...v3.1.0-alpha](https://github.com/team-telnyx/telnyx-python/compare/v3.0.0-alpha...v3.1.0-alpha)

api.md

@@ -1221,6 +1221,7 @@ from telnyx.types import (
     DocumentUpdateResponse,
     DocumentListResponse,
     DocumentDeleteResponse,
+    DocumentGenerateDownloadLinkResponse,
     DocumentUploadResponse,
 )
 ```
@@ -1232,6 +1233,7 @@ Methods:
 - <code title="get /documents">client.documents.<a href="./src/telnyx/resources/documents.py">list</a>(\*\*<a href="src/telnyx/types/document_list_params.py">params</a>) -> <a href="./src/telnyx/types/document_list_response.py">DocumentListResponse</a></code>
 - <code title="delete /documents/{id}">client.documents.<a href="./src/telnyx/resources/documents.py">delete</a>(id) -> <a href="./src/telnyx/types/document_delete_response.py">DocumentDeleteResponse</a></code>
 - <code title="get /documents/{id}/download">client.documents.<a href="./src/telnyx/resources/documents.py">download</a>(id) -> BinaryAPIResponse</code>
+- <code title="get /documents/{id}/download_link">client.documents.<a href="./src/telnyx/resources/documents.py">generate_download_link</a>(id) -> <a href="./src/telnyx/types/document_generate_download_link_response.py">DocumentGenerateDownloadLinkResponse</a></code>
 - <code title="post /documents">client.documents.<a href="./src/telnyx/resources/documents.py">upload</a>(\*\*<a href="src/telnyx/types/document_upload_params.py">params</a>) -> <a href="./src/telnyx/types/document_upload_response.py">DocumentUploadResponse</a></code>
 
 # DynamicEmergencyAddresses

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "telnyx"
-version = "3.1.0-alpha"
+version = "3.2.0-alpha"
 description = "The official Python library for the telnyx API"
 dynamic = ["readme"]
 license = "MIT"

src/telnyx/_version.py

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

src/telnyx/resources/documents.py

@@ -32,6 +32,7 @@
 from ..types.document_update_response import DocumentUpdateResponse
 from ..types.document_upload_response import DocumentUploadResponse
 from ..types.document_retrieve_response import DocumentRetrieveResponse
+from ..types.document_generate_download_link_response import DocumentGenerateDownloadLinkResponse
 
 __all__ = ["DocumentsResource", "AsyncDocumentsResource"]
 
@@ -259,6 +260,40 @@ def download(
             cast_to=BinaryAPIResponse,
         )
 
+    def generate_download_link(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DocumentGenerateDownloadLinkResponse:
+        """
+        Generates a temporary pre-signed URL that can be used to download the document
+        directly from the storage backend without authentication.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            f"/documents/{id}/download_link",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DocumentGenerateDownloadLinkResponse,
+        )
+
     @overload
     def upload(
         self,
@@ -593,6 +628,40 @@ async def download(
             cast_to=AsyncBinaryAPIResponse,
         )
 
+    async def generate_download_link(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> DocumentGenerateDownloadLinkResponse:
+        """
+        Generates a temporary pre-signed URL that can be used to download the document
+        directly from the storage backend without authentication.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            f"/documents/{id}/download_link",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DocumentGenerateDownloadLinkResponse,
+        )
+
     @overload
     async def upload(
         self,
@@ -724,6 +793,9 @@ def __init__(self, documents: DocumentsResource) -> None:
             documents.download,
             BinaryAPIResponse,
         )
+        self.generate_download_link = to_raw_response_wrapper(
+            documents.generate_download_link,
+        )
         self.upload = to_raw_response_wrapper(
             documents.upload,
         )
@@ -749,6 +821,9 @@ def __init__(self, documents: AsyncDocumentsResource) -> None:
             documents.download,
             AsyncBinaryAPIResponse,
         )
+        self.generate_download_link = async_to_raw_response_wrapper(
+            documents.generate_download_link,
+        )
         self.upload = async_to_raw_response_wrapper(
             documents.upload,
         )
@@ -774,6 +849,9 @@ def __init__(self, documents: DocumentsResource) -> None:
             documents.download,
             StreamedBinaryAPIResponse,
         )
+        self.generate_download_link = to_streamed_response_wrapper(
+            documents.generate_download_link,
+        )
         self.upload = to_streamed_response_wrapper(
             documents.upload,
         )
@@ -799,6 +877,9 @@ def __init__(self, documents: AsyncDocumentsResource) -> None:
             documents.download,
             AsyncStreamedBinaryAPIResponse,
         )
+        self.generate_download_link = async_to_streamed_response_wrapper(
+            documents.generate_download_link,
+        )
         self.upload = async_to_streamed_response_wrapper(
             documents.upload,
         )

src/telnyx/types/__init__.py

@@ -893,6 +893,9 @@
 from .call_control_application_update_response import (
     CallControlApplicationUpdateResponse as CallControlApplicationUpdateResponse,
 )
+from .document_generate_download_link_response import (
+    DocumentGenerateDownloadLinkResponse as DocumentGenerateDownloadLinkResponse,
+)
 from .dynamic_emergency_endpoint_create_params import (
     DynamicEmergencyEndpointCreateParams as DynamicEmergencyEndpointCreateParams,
 )

src/telnyx/types/document_generate_download_link_response.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["DocumentGenerateDownloadLinkResponse", "Data"]
+
+
+class Data(BaseModel):
+    url: str
+    """Pre-signed temporary URL for downloading the document"""
+
+
+class DocumentGenerateDownloadLinkResponse(BaseModel):
+    data: Data

tests/api_resources/test_documents.py

@@ -17,6 +17,7 @@
     DocumentUpdateResponse,
     DocumentUploadResponse,
     DocumentRetrieveResponse,
+    DocumentGenerateDownloadLinkResponse,
 )
 from telnyx._utils import parse_datetime
 from telnyx._response import (
@@ -275,6 +276,48 @@ def test_path_params_download(self, client: Telnyx) -> None:
                 "",
             )
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_generate_download_link(self, client: Telnyx) -> None:
+        document = client.documents.generate_download_link(
+            "550e8400-e29b-41d4-a716-446655440000",
+        )
+        assert_matches_type(DocumentGenerateDownloadLinkResponse, document, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_raw_response_generate_download_link(self, client: Telnyx) -> None:
+        response = client.documents.with_raw_response.generate_download_link(
+            "550e8400-e29b-41d4-a716-446655440000",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        document = response.parse()
+        assert_matches_type(DocumentGenerateDownloadLinkResponse, document, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_streaming_response_generate_download_link(self, client: Telnyx) -> None:
+        with client.documents.with_streaming_response.generate_download_link(
+            "550e8400-e29b-41d4-a716-446655440000",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            document = response.parse()
+            assert_matches_type(DocumentGenerateDownloadLinkResponse, document, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_path_params_generate_download_link(self, client: Telnyx) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            client.documents.with_raw_response.generate_download_link(
+                "",
+            )
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_upload_overload_1(self, client: Telnyx) -> None:
@@ -612,6 +655,48 @@ async def test_path_params_download(self, async_client: AsyncTelnyx) -> None:
                 "",
             )
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_generate_download_link(self, async_client: AsyncTelnyx) -> None:
+        document = await async_client.documents.generate_download_link(
+            "550e8400-e29b-41d4-a716-446655440000",
+        )
+        assert_matches_type(DocumentGenerateDownloadLinkResponse, document, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_raw_response_generate_download_link(self, async_client: AsyncTelnyx) -> None:
+        response = await async_client.documents.with_raw_response.generate_download_link(
+            "550e8400-e29b-41d4-a716-446655440000",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        document = await response.parse()
+        assert_matches_type(DocumentGenerateDownloadLinkResponse, document, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_streaming_response_generate_download_link(self, async_client: AsyncTelnyx) -> None:
+        async with async_client.documents.with_streaming_response.generate_download_link(
+            "550e8400-e29b-41d4-a716-446655440000",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            document = await response.parse()
+            assert_matches_type(DocumentGenerateDownloadLinkResponse, document, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_path_params_generate_download_link(self, async_client: AsyncTelnyx) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
+            await async_client.documents.with_raw_response.generate_download_link(
+                "",
+            )
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_upload_overload_1(self, async_client: AsyncTelnyx) -> None: