docs: Add comprehensive Sonar Embedded API documentation

.markdownlint.jsonc

@@ -13,5 +13,6 @@
     },
     "MD004": {
         "style": "dash" // Enforce "dash" style for unordered list items (e.g., "- item")
-    }
+    },
+    "MD024": { "siblings_only": true } // Allow duplicate headings in different sections
 }

docs/ai-agents/embedded/api/README.md

@@ -1,5 +1,7 @@
 ---
+
 products: embedded
+
 ---
 
 # Airbyte API
@@ -11,15 +13,17 @@ The Airbyte API allows you to build a fully integrated Airbyte Embedded Experien
 Follow these steps to implement Airbyte Embedded with the API:
 
 ### 1. One-Time Setup (Your Organization)
+
 First, configure the foundation for your embedded integration:
 
 1. **[Create Connection Templates](./connection-templates.md)**: Define where your users' data will be stored (destination configuration)
 2. **[Create Source Templates](./source-templates.md)**: Choose which data connectors your users can access
 
 ### 2. Per-User Integration (Runtime)
+
 For each user who wants to connect their data:
 
-3. **[Generate User Tokens & Configure Sources](./configuring-sources.md)**: Authenticate users and collect their source credentials
+1. **[Generate User Tokens & Configure Sources](./configuring-sources.md)**: Authenticate users and collect their source credentials
 
 This approach separates one-time organizational setup from per-user operations, making your integration more scalable.