diff --git a/api-reference/doc-tool/doc-tool.yaml b/api-reference/doc-tool/doc-tool.yaml
index 18c407e..6c91c5c 100644
--- a/api-reference/doc-tool/doc-tool.yaml
+++ b/api-reference/doc-tool/doc-tool.yaml
@@ -2095,6 +2095,12 @@ paths:
               properties:
                 partner_appointment_id:
                   type: string
+                partner_patient_id:
+                  type: string
+                  description: 'Identifier for the partner’s patient. Please ensure the patient is registered beforehand using the "Add Patient" API. This field should not be used in combination with `patient_id` — only one of the two should be provided. If partner_patient_id is provided, it will exhibit eventual consistency.'
+                patient_id:
+                  type: string
+                  description: 'Identifier for the patient in Eka. This field should not be used in combination with `partner_patient_id` — only one of the two should be provided.'
                 appointment_details:
                   type: object
                   properties:
@@ -2207,13 +2213,9 @@ paths:
                     partner_doctor_id:
                       type: string
                       description: 'Identifier for the partner’s doctor. Please ensure the doctor is registered on the hub'
-                    partner_patient_id:
-                      type: string
-                      description: 'Identifier for the partner’s patient. Please ensure the patient is registered beforehand using the "Add Patient" API.'
                   required:
                     - partner_clinic_id
                     - partner_doctor_id
-                    - partner_patient_id
 
                 - title: EkaIds
                   properties:
@@ -2223,13 +2225,9 @@ paths:
                     doctor_id:
                       type: string
                       description: 'Identifier for the doctor in Eka.'
-                    patient_id:
-                      type: string
-                      description: 'Identifier for the patient in Eka.'
                   required:
                     - clinic_id
                     - doctor_id
-                    - patient_id
 
               required:
                 - appointment_details
@@ -3769,6 +3767,13 @@ paths:
             schema:
               type: object
               properties:
+                partner_patient_id:
+                  type: string
+                  description: 'Identifier for the partner’s patient. Please ensure the patient is registered beforehand using the "Add Patient" API. This field should not be used in combination with `patient_id` — only one of the two should be provided. If partner_patient_id is provided, it will exhibit eventual consistency.'
+                patient_id:
+                  type: string
+                  description: 'Identifier for the patient in Eka. This field should not be used in combination with `partner_patient_id` — only one of the two should be provided.'
+                
                 appointment_details:
                   type: object
                   properties:
@@ -3865,14 +3870,9 @@ paths:
                         type: string
                         description: 'Identifier for the doctor in Eka.'
                         example: "6742984"
-                      patient_id:
-                        type: string
-                        description: 'Identifier for the patient in Eka.'
-                        example: "6742984"
                     required:
                       - clinic_id
                       - doctor_id
-                      - patient_id
 
                   - title: PartnerIds
                     properties:
@@ -3884,14 +3884,9 @@ paths:
                         type: string
                         description: 'Identifier for the partner’s doctor. Please ensure the doctor is registered on the hub'
                         example: "6742984"
-                      partner_patient_id:
-                        type: string
-                        description: 'Identifier for the partner’s patient. Please ensure the patient is registered beforehand using the "Add Patient" API.'
-                        example: "6742984"
                     required:
                       - partner_clinic_id
                       - partner_doctor_id
-                      - partner_patient_id
 
       responses:
         '204':