chore(api): update composite API spec

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 2018
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-96674708a71bdccf65c32cfde3668102802ddcbd0013e0e6bea5fe5a15e96c2d.yml
-openapi_spec_hash: 07913982475b8cd9b10e68db898a4047
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-502ff5e05c48b9d2cafd71f7fa1b833f7ccf8f328350e5f4648d065d456e765c.yml
+openapi_spec_hash: 659199fd85eae22382ad710a8b1d7be1
 config_hash: 7a08b6d7e050d324501d76c833118c84

src/cloudflare/resources/mtls_certificates/mtls_certificates.py

@@ -74,7 +74,10 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Optional[MTLSCertificateCreateResponse]:
         """
-        Upload a certificate that you want to use with mTLS-enabled Cloudflare services.
+        Upload a certificate that you want to use with mTLS-enabled Cloudflare services,
+        such as Bring Your Own CA (BYO-CA) for mTLS. To create certificates issued by
+        the Cloudflare managed CA, use the
+        [Create Client Certificate endpoint](/api/resources/client_certificates/methods/create/).
 
         Args:
           account_id: Identifier.
@@ -131,7 +134,10 @@ def list(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SyncSinglePage[MTLSCertificate]:
         """
-        Lists all mTLS certificates.
+        Lists all mTLS certificates uploaded to your account, such as Bring Your Own CA
+        (BYO-CA) for mTLS. To list certificates issued by the Cloudflare managed CA, use
+        the
+        [List Client Certificates endpoint](/api/resources/client_certificates/methods/list/).
 
         Args:
           account_id: Identifier.
@@ -214,8 +220,11 @@ def get(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Optional[MTLSCertificate]:
-        """
-        Fetches a single mTLS certificate.
+        """Fetches a single mTLS certificate uploaded to your account.
+
+        To get a certificate
+        issued by the Cloudflare managed CA, use the
+        [Client Certificate Details endpoint](/api/resources/client_certificates/methods/get/).
 
         Args:
           account_id: Identifier.
@@ -289,7 +298,10 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Optional[MTLSCertificateCreateResponse]:
         """
-        Upload a certificate that you want to use with mTLS-enabled Cloudflare services.
+        Upload a certificate that you want to use with mTLS-enabled Cloudflare services,
+        such as Bring Your Own CA (BYO-CA) for mTLS. To create certificates issued by
+        the Cloudflare managed CA, use the
+        [Create Client Certificate endpoint](/api/resources/client_certificates/methods/create/).
 
         Args:
           account_id: Identifier.
@@ -346,7 +358,10 @@ def list(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncPaginator[MTLSCertificate, AsyncSinglePage[MTLSCertificate]]:
         """
-        Lists all mTLS certificates.
+        Lists all mTLS certificates uploaded to your account, such as Bring Your Own CA
+        (BYO-CA) for mTLS. To list certificates issued by the Cloudflare managed CA, use
+        the
+        [List Client Certificates endpoint](/api/resources/client_certificates/methods/list/).
 
         Args:
           account_id: Identifier.
@@ -429,8 +444,11 @@ async def get(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Optional[MTLSCertificate]:
-        """
-        Fetches a single mTLS certificate.
+        """Fetches a single mTLS certificate uploaded to your account.
+
+        To get a certificate
+        issued by the Cloudflare managed CA, use the
+        [Client Certificate Details endpoint](/api/resources/client_certificates/methods/get/).
 
         Args:
           account_id: Identifier.