From 0ad914903690ebf9850158c24264fbf2380edba2 Mon Sep 17 00:00:00 2001
From: srothh <simon.roth@sentry.io>
Date: Wed, 6 Aug 2025 13:36:24 +0200
Subject: [PATCH] docs(python): Add documentation for the Python SDK Async
 Transport Option

---
 docs/platforms/python/configuration/options.mdx | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/platforms/python/configuration/options.mdx b/docs/platforms/python/configuration/options.mdx
index a16caac7bb578..979cbcbe8a258 100644
--- a/docs/platforms/python/configuration/options.mdx
+++ b/docs/platforms/python/configuration/options.mdx
@@ -320,6 +320,22 @@ sentry_sdk.init(
 
 </SdkOption>
 
+<SdkOption name="transport_async" defaultValue='None'>
+An experimental fully async transport. Requires the asyncio integration and the [httpcore[asyncio]](https://www.encode.io/httpcore/async/) library. If enabled, the Sentry SDK has to be initialised while an event loop is running.
+
+```python
+sentry_sdk.init(
+    _experiments={
+        "transport_async": True,
+    },
+    integrations=[
+        AsyncioIntegration(),
+    ],
+)
+```
+
+</SdkOption>
+
 ## Tracing Options
 
 <SdkOption name="traces_sample_rate" type='float' defaultValue='None'>