diff --git a/.github/workflows/manual_version_docs.yaml b/.github/workflows/manual_version_docs.yaml
index 66a2838b..662cb104 100644
--- a/.github/workflows/manual_version_docs.yaml
+++ b/.github/workflows/manual_version_docs.yaml
@@ -120,10 +120,12 @@ jobs:
             echo "No existing versions found for major $MAJOR_VERSION, nothing to remove"
           fi
 
-          # Build API reference and create Docusaurus version snapshots.
+          # Build API reference and create Docusaurus version snapshots. The Docusaurus commands must run
+          # through `uv run` so that the project virtual environment is on PATH — the typedoc-api plugin
+          # spawns `python` to generate the API reference dump and needs `pydoc-markdown` to be importable.
           bash build_api_reference.sh
-          pnpm exec docusaurus docs:version "$MAJOR_MINOR_VERSION"
-          pnpm exec docusaurus api:version "$MAJOR_MINOR_VERSION"
+          uv run pnpm exec docusaurus docs:version "$MAJOR_MINOR_VERSION"
+          uv run pnpm exec docusaurus api:version "$MAJOR_MINOR_VERSION"
 
       - name: Commit and push versioned docs
         uses: apify/actions/signed-commit@v1.2.0