diff --git a/.github/workflows/validate-config-schema.yml b/.github/workflows/validate-config-schema.yml
index 48404aef..46f65b4d 100644
--- a/.github/workflows/validate-config-schema.yml
+++ b/.github/workflows/validate-config-schema.yml
@@ -35,7 +35,7 @@ jobs:
         uses: astral-sh/setup-uv@6ee6290f1cbc4156c0bdd66691b2c144ef8df19a  # v7.4.0
 
       - name: Install dependencies
-        run: uv pip install --system "pydantic>=2.10.0,<3.0.0"
+        run: uv pip install --system "pydantic==2.12.5"
 
       - name: Regenerate schema
         run: python data-pipeline/capture/config/generate_config_schema.py
@@ -49,7 +49,7 @@ jobs:
             echo "The JSON Schema file does not match the current pydantic models."
             echo "If the models have changed intentionally, regenerate the schema by running the following command locally:"
             echo ""
-            echo "  uv pip install pydantic && python data-pipeline/capture/config/generate_config_schema.py"
+            echo "  uv pip install 'pydantic==2.12.5' && python data-pipeline/capture/config/generate_config_schema.py"
             echo ""
             echo "Then commit the updated schema file."
             echo ""
diff --git a/data-pipeline/capture/config/README.md b/data-pipeline/capture/config/README.md
index 48a1be44..1ccc9590 100644
--- a/data-pipeline/capture/config/README.md
+++ b/data-pipeline/capture/config/README.md
@@ -215,7 +215,7 @@ Regenerate the schema whenever you modify:
 
 ```bash
 # Run the schema generation script
-pip install pydantic && PYTHONPATH=. python config/generate_config_schema.py
+pip install 'pydantic==2.12.5' && PYTHONPATH=. python config/generate_config_schema.py
 
 # Verify the updated schema
 git diff config/recording_config.schema.json
@@ -236,5 +236,5 @@ The CI/CD pipeline validates that the schema is up-to-date with the pydantic mod
 
 ## 🔗 Related Documentation
 
-* [LeRobot Integration](../docs/lerobot-inference.md) - Dataset structure and feature mapping
-* [AzureML Validation Job Debugging](../docs/azureml-validation-job-debugging.md) - Training pipeline integration
+* [LeRobot Integration](../docs/inference/lerobot-inference.md) - Dataset structure and feature mapping
+* [AzureML Validation Job Debugging](../docs/operations/azureml-validation-job-debugging.md) - Training pipeline integration
diff --git a/pyproject.toml b/pyproject.toml
index a3a618db..20a059e1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -18,7 +18,7 @@ dev = [
     "pytest",
     "pytest-mock",
     "pytest-cov",
-    "pydantic",
+    "pydantic==2.12.5",
     "ipykernel",
     "ipywidgets",
     "tqdm",