feat: feat(tomarkdown): add new markdown supported endpoint

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1891
+configured_endpoints: 1892
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-aa2c3728465401b156b0ae35cb80cfef39ae398866f7b44b52dba8dd04d7df0c.yml
 openapi_spec_hash: afffe386ef9475dfec98d1c26d8225d4
-config_hash: f8ad41a1e87119e46c6452f8f1ea0440
+config_hash: 002f3cbea44c410d7ee7e31fa9b0058a

api.md

@@ -10126,11 +10126,12 @@ Methods:
 Types:
 
 ```python
-from cloudflare.types.ai import ToMarkdownTransformResponse
+from cloudflare.types.ai import ToMarkdownSupportedResponse, ToMarkdownTransformResponse
 ```
 
 Methods:
 
+- <code title="get /accounts/{account_id}/ai/tomarkdown/supported">client.ai.to_markdown.<a href="./src/cloudflare/resources/ai/to_markdown.py">supported</a>(\*, account_id) -> <a href="./src/cloudflare/types/ai/to_markdown_supported_response.py">SyncSinglePage[ToMarkdownSupportedResponse]</a></code>
 - <code title="post /accounts/{account_id}/ai/tomarkdown">client.ai.to_markdown.<a href="./src/cloudflare/resources/ai/to_markdown.py">transform</a>(file, \*, account_id, \*\*<a href="src/cloudflare/types/ai/to_markdown_transform_params.py">params</a>) -> <a href="./src/cloudflare/types/ai/to_markdown_transform_response.py">SyncSinglePage[ToMarkdownTransformResponse]</a></code>
 
 # SecurityCenter

src/cloudflare/resources/ai/to_markdown.py

@@ -16,6 +16,7 @@
 )
 from ...pagination import SyncSinglePage, AsyncSinglePage
 from ..._base_client import AsyncPaginator, make_request_options
+from ...types.ai.to_markdown_supported_response import ToMarkdownSupportedResponse
 from ...types.ai.to_markdown_transform_response import ToMarkdownTransformResponse
 
 __all__ = ["ToMarkdownResource", "AsyncToMarkdownResource"]
@@ -41,6 +42,40 @@ def with_streaming_response(self) -> ToMarkdownResourceWithStreamingResponse:
         """
         return ToMarkdownResourceWithStreamingResponse(self)
 
+    def supported(
+        self,
+        *,
+        account_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,
+    ) -> SyncSinglePage[ToMarkdownSupportedResponse]:
+        """
+        Get all converted formats supported
+
+        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 account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        return self._get_api_list(
+            f"/accounts/{account_id}/ai/tomarkdown/supported",
+            page=SyncSinglePage[ToMarkdownSupportedResponse],
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            model=ToMarkdownSupportedResponse,
+        )
+
     def transform(
         self,
         file: FileContent,
@@ -100,6 +135,40 @@ def with_streaming_response(self) -> AsyncToMarkdownResourceWithStreamingRespons
         """
         return AsyncToMarkdownResourceWithStreamingResponse(self)
 
+    def supported(
+        self,
+        *,
+        account_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,
+    ) -> AsyncPaginator[ToMarkdownSupportedResponse, AsyncSinglePage[ToMarkdownSupportedResponse]]:
+        """
+        Get all converted formats supported
+
+        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 account_id:
+            raise ValueError(f"Expected a non-empty value for `account_id` but received {account_id!r}")
+        return self._get_api_list(
+            f"/accounts/{account_id}/ai/tomarkdown/supported",
+            page=AsyncSinglePage[ToMarkdownSupportedResponse],
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            model=ToMarkdownSupportedResponse,
+        )
+
     def transform(
         self,
         file: FileContent,
@@ -143,6 +212,9 @@ class ToMarkdownResourceWithRawResponse:
     def __init__(self, to_markdown: ToMarkdownResource) -> None:
         self._to_markdown = to_markdown
 
+        self.supported = to_raw_response_wrapper(
+            to_markdown.supported,
+        )
         self.transform = to_raw_response_wrapper(
             to_markdown.transform,
         )
@@ -152,6 +224,9 @@ class AsyncToMarkdownResourceWithRawResponse:
     def __init__(self, to_markdown: AsyncToMarkdownResource) -> None:
         self._to_markdown = to_markdown
 
+        self.supported = async_to_raw_response_wrapper(
+            to_markdown.supported,
+        )
         self.transform = async_to_raw_response_wrapper(
             to_markdown.transform,
         )
@@ -161,6 +236,9 @@ class ToMarkdownResourceWithStreamingResponse:
     def __init__(self, to_markdown: ToMarkdownResource) -> None:
         self._to_markdown = to_markdown
 
+        self.supported = to_streamed_response_wrapper(
+            to_markdown.supported,
+        )
         self.transform = to_streamed_response_wrapper(
             to_markdown.transform,
         )
@@ -170,6 +248,9 @@ class AsyncToMarkdownResourceWithStreamingResponse:
     def __init__(self, to_markdown: AsyncToMarkdownResource) -> None:
         self._to_markdown = to_markdown
 
+        self.supported = async_to_streamed_response_wrapper(
+            to_markdown.supported,
+        )
         self.transform = async_to_streamed_response_wrapper(
             to_markdown.transform,
         )

src/cloudflare/types/ai/__init__.py

@@ -9,4 +9,5 @@
 from .finetune_list_response import FinetuneListResponse as FinetuneListResponse
 from .finetune_create_response import FinetuneCreateResponse as FinetuneCreateResponse
 from .to_markdown_transform_params import ToMarkdownTransformParams as ToMarkdownTransformParams
+from .to_markdown_supported_response import ToMarkdownSupportedResponse as ToMarkdownSupportedResponse
 from .to_markdown_transform_response import ToMarkdownTransformResponse as ToMarkdownTransformResponse

src/cloudflare/types/ai/to_markdown_supported_response.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["ToMarkdownSupportedResponse"]
+
+
+class ToMarkdownSupportedResponse(BaseModel):
+    extension: str
+
+    mime_type: str = FieldInfo(alias="mimeType")

tests/api_resources/ai/test_to_markdown.py

@@ -9,7 +9,7 @@
 
 from cloudflare import Cloudflare, AsyncCloudflare
 from tests.utils import assert_matches_type
-from cloudflare.types.ai import ToMarkdownTransformResponse
+from cloudflare.types.ai import ToMarkdownSupportedResponse, ToMarkdownTransformResponse
 from cloudflare.pagination import SyncSinglePage, AsyncSinglePage
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
@@ -18,6 +18,44 @@
 class TestToMarkdown:
     parametrize = pytest.mark.parametrize("client", [False, True], indirect=True, ids=["loose", "strict"])
 
+    @parametrize
+    def test_method_supported(self, client: Cloudflare) -> None:
+        to_markdown = client.ai.to_markdown.supported(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+        assert_matches_type(SyncSinglePage[ToMarkdownSupportedResponse], to_markdown, path=["response"])
+
+    @parametrize
+    def test_raw_response_supported(self, client: Cloudflare) -> None:
+        response = client.ai.to_markdown.with_raw_response.supported(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        to_markdown = response.parse()
+        assert_matches_type(SyncSinglePage[ToMarkdownSupportedResponse], to_markdown, path=["response"])
+
+    @parametrize
+    def test_streaming_response_supported(self, client: Cloudflare) -> None:
+        with client.ai.to_markdown.with_streaming_response.supported(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            to_markdown = response.parse()
+            assert_matches_type(SyncSinglePage[ToMarkdownSupportedResponse], to_markdown, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    def test_path_params_supported(self, client: Cloudflare) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
+            client.ai.to_markdown.with_raw_response.supported(
+                account_id="",
+            )
+
     @parametrize
     def test_method_transform(self, client: Cloudflare) -> None:
         to_markdown = client.ai.to_markdown.transform(
@@ -66,6 +104,44 @@ class TestAsyncToMarkdown:
         "async_client", [False, True, {"http_client": "aiohttp"}], indirect=True, ids=["loose", "strict", "aiohttp"]
     )
 
+    @parametrize
+    async def test_method_supported(self, async_client: AsyncCloudflare) -> None:
+        to_markdown = await async_client.ai.to_markdown.supported(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+        assert_matches_type(AsyncSinglePage[ToMarkdownSupportedResponse], to_markdown, path=["response"])
+
+    @parametrize
+    async def test_raw_response_supported(self, async_client: AsyncCloudflare) -> None:
+        response = await async_client.ai.to_markdown.with_raw_response.supported(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        to_markdown = await response.parse()
+        assert_matches_type(AsyncSinglePage[ToMarkdownSupportedResponse], to_markdown, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_supported(self, async_client: AsyncCloudflare) -> None:
+        async with async_client.ai.to_markdown.with_streaming_response.supported(
+            account_id="023e105f4ecef8ad9ca31a8372d0c353",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            to_markdown = await response.parse()
+            assert_matches_type(AsyncSinglePage[ToMarkdownSupportedResponse], to_markdown, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+    @parametrize
+    async def test_path_params_supported(self, async_client: AsyncCloudflare) -> None:
+        with pytest.raises(ValueError, match=r"Expected a non-empty value for `account_id` but received ''"):
+            await async_client.ai.to_markdown.with_raw_response.supported(
+                account_id="",
+            )
+
     @parametrize
     async def test_method_transform(self, async_client: AsyncCloudflare) -> None:
         to_markdown = await async_client.ai.to_markdown.transform(