From 214e7d7e7c0f24108117ca37af4adb672536946d Mon Sep 17 00:00:00 2001
From: Gokulvarthan Ramesh <gokulvarthan.r@cureselecthealthcare.com>
Date: Mon, 31 Aug 2026 11:04:20 +0530
Subject: [PATCH] Update API_DOCUMENTATION.md with optional category and
 auto-triage

---
 API_DOCUMENTATION.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/API_DOCUMENTATION.md b/API_DOCUMENTATION.md
index 3624347..527f959 100644
--- a/API_DOCUMENTATION.md
+++ b/API_DOCUMENTATION.md
@@ -113,7 +113,7 @@ Creates a new voice onboarding session, initializes dynamic state, and returns l
 
 - **URL:** `POST /v1/voice-onboarding/start`
 - **Headers:** `Content-Type: application/json`
-- **Request Body:**
+- **Request Body:** *(Note: `category` is optional and defaults to Auto-Triage General Medicine)*
 ```json
 {
   "patient": {
@@ -122,19 +122,19 @@ Creates a new voice onboarding session, initializes dynamic state, and returns l
     "age": 42,
     "gender": "male",
     "abha_id": "91-1234-5678-9012",
-    "phone": "+91 98765 43210",
-    "insurance_scheme": "PM-JAY",
-    "dietary_habits": "Vegetarian"
+    "phone": "+91 98765 43210"
   },
   "category": {
-    "type": "speciality",
-    "code": "cardio",
-    "name": "Cardiology"
+    "type": "general",
+    "code": "general_medicine",
+    "name": "General Medicine / Primary Care (Auto-Triage)"
   },
-  "language": "en-IN"
+  "language": "ta-IN"
 }
 ```
 
+> 💡 **Automatic Specialty Auto-Triage**: If `category` is omitted, the API defaults to General Medicine. During the conversation, the AI automatically analyzes the patient's symptoms and assigns the exact specialty (`suggested_specialty`) in real-time.
+
 - **Response (`200 OK`):**
 ```json
 {