add a site merge endpoint for clinics

reference/clinic.v1.yaml

@@ -1010,6 +1010,28 @@
       description: 'Delete a Site'
       tags:
         - Clinics
+  '/v1/clinics/{clinicId}/sites/{siteId}/merge':
+    parameters:
+      - $ref: '#/components/parameters/clinicId'
+      - $ref: '#/components/parameters/siteId'
+    post:
+      summary: Merge two sites
+      operationId: MergeSite
+      responses:
+        '200':
+          description: The merged clinic site
+          content:
+            application/json:
+              schema:
+                $ref: ./clinic/models/site.v1.yaml
+      description: Merge a site, identified in the request body, into the site identified in the URL.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: ./clinic/models/siteById.v1.yaml
+      tags:
+        - Clinics
   '/v1/clinics/{clinicId}/clinicians/{clinicianId}':
     parameters:
       - $ref: '#/components/parameters/clinicId'
@@ -1143,6 +1165,25 @@
       description: Removes a patient tag from a clinic and tagged patients
       tags:
         - Clinics
+  '/v1/clinics/{clinicId}/patient_tags/{patientTagId}/site':
+    parameters:
+      - $ref: '#/components/parameters/clinicId'
+      - $ref: '#/components/parameters/patientTagId'
+    post:
+      summary: Convert Patient Tag to Site
+      operationId: ConvertPatientTagToSite
+      responses:
+        '200':
+          description: The newly converted site.
+          content:
+            application/json:
+              schema:
+                $ref: ./clinic/models/site.v1.yaml
+        '409':
+          description: Cannot convert the tag to a site. This could occur for example when the maximum number of sites has already been reached.
+      description: Convert a patient tag to a site.
+      tags:
+        - Clinics
   '/v1/clinics/{clinicId}/invites/clinicians':
     parameters:
       - $ref: '#/components/parameters/clinicId'
@@ -2066,7 +2107,7 @@
 
         https://sandbox.xealth.io/app/api-docs#tag/Digital-Care/paths/preorder/post
   /v1/xealth/programs:
     put:
       summary: Get Programs
       operationId: XealthGetPrograms
       responses:
@@ -2083,7 +2124,7 @@
       responses:
         '200':
           description: OK
       description: ''
       tags:
         - Clinics
         - Internal
@@ -2095,7 +2136,7 @@
       responses:
         '200':
           description: OK
       description: ''
       tags:
         - Clinics
         - Internal

reference/clinic/models/siteById.v1.yaml

@@ -0,0 +1,8 @@
+type: object
+title: SiteById
+description: "A clinic's physical or logical location—id only."
+properties:
+  id:
+    $ref: ../../../reference/common/models/objectid.v1.yaml
+required:
+  - id