From 2ba3442f03a959320dfa8db261d88503390fd1a8 Mon Sep 17 00:00:00 2001
From: clintonium-119 <clint.beacock@gmail.com>
Date: Wed, 21 Jun 2023 16:02:39 -0400
Subject: [PATCH 1/2] Bulk assign/remove tags from clinic patients

---
 reference/clinic.v1.yaml | 64 ++++++++++++++++++++++++++++++----------
 1 file changed, 49 insertions(+), 15 deletions(-)

diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml
index ee961afe..2f4f4039 100644
--- a/reference/clinic.v1.yaml
+++ b/reference/clinic.v1.yaml
@@ -251,17 +251,17 @@ paths:
         - schema:
             type: string
             pattern: ^(cgm|bgm)$
-            example: 'cgm'
+            example: cgm
           in: query
           name: sortType
           description: Summary type to sort by
         - schema:
             type: string
             pattern: ^(1d|7d|14d|30d)$
-            example: '7d'
+            example: 7d
           in: query
           name: period
-          description: Time Period to display, filter, and sort
+          description: 'Time Period to display, filter, and sort'
         - schema:
             type: string
             pattern: ^(>=|>|<=|<)\d\.\d\d?$
@@ -1220,17 +1220,43 @@ paths:
       description: Resend Dexcom connect request to the email address of the patient
       tags:
         - Clinics
+  '/v1/clinics/{clinicId}/patients/assign_tag/{patientTagId}':
+    parameters:
+      - $ref: '#/components/parameters/clinicId'
+      - $ref: '#/components/parameters/patientTagId'
+    post:
+      summary: Assign Patient Tag To Clinic Patients
+      operationId: AssignPatientTagToClinicPatients
+      requestBody:
+        description: Pass an array of patient IDs to target a subset of the clinic patients. Omit request body to target all clinic patients.
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TidepoolUserIds'
+      responses:
+        '200':
+          description: OK
+      description: Assign a patient tag to all or a subset of clinic patients
+      tags:
+        - Clinics
+        - Internal
   '/v1/clinics/{clinicId}/patients/delete_tag/{patientTagId}':
     parameters:
       - $ref: '#/components/parameters/clinicId'
       - $ref: '#/components/parameters/patientTagId'
-    delete:
+    post:
       summary: Delete Patient Tag From Clinic Patients
       operationId: DeletePatientTagFromClinicPatients
+      requestBody:
+        description: Pass an array of patient IDs to target a subset of the clinic patients. Omit request body to target all clinic patients.
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TidepoolUserIds'
       responses:
         '200':
           description: OK
-      description: Delete a patient tag from all clinic patients
+      description: Delete a patient tag from all or a subset of clinic patients
       tags:
         - Clinics
         - Internal
@@ -1313,6 +1339,14 @@ components:
       $ref: ./clinic/models/inviteclinician.v1.yaml
     TidepoolUserId:
       $ref: ./common/models/tidepooluserid.yaml
+    TidepoolUserIds:
+      type: array
+      description: Array of Tidepool User IDs
+      items:
+        $ref: '#/components/schemas/TidepoolUserId'
+      minItems: 1
+      maxItems: 1000
+      uniqueItems: true
     ClinicianRoles:
       $ref: ./clinic/models/clinicianroles.v1.yaml
     PhoneNumber:
@@ -1443,25 +1477,25 @@ components:
         attestationSubmitted:
           type: boolean
     AverageGlucose:
-      $ref: './data/models/blood/glucose/glucosemmol.v1.yaml'
+      $ref: ./data/models/blood/glucose/glucosemmol.v1.yaml
     PatientBGMPeriod:
-      $ref: './summary/models/bgmperiod.v1.yaml'
+      $ref: ./summary/models/bgmperiod.v1.yaml
     PatientBGMPeriods:
-      $ref: './clinic/models/summaries/bgmperiods.v1.yaml'
+      $ref: ./clinic/models/summaries/bgmperiods.v1.yaml
     PatientBGMStats:
-      $ref: './clinic/models/summaries/bgmstats.v1.yaml'
+      $ref: ./clinic/models/summaries/bgmstats.v1.yaml
     PatientCGMPeriod:
-      $ref: './summary/models/cgmperiod.v1.yaml'
+      $ref: ./summary/models/cgmperiod.v1.yaml
     PatientCGMPeriods:
-      $ref: './clinic/models/summaries/cgmperiods.v1.yaml'
+      $ref: ./clinic/models/summaries/cgmperiods.v1.yaml
     PatientCGMStats:
-      $ref: './clinic/models/summaries/cgmstats.v1.yaml'
+      $ref: ./clinic/models/summaries/cgmstats.v1.yaml
     PatientSummaryConfig:
-      $ref: './summary/models/config.v1.yaml'
+      $ref: ./summary/models/config.v1.yaml
     PatientSummaryDates:
-      $ref: './summary/models/dates.v1.yaml'
+      $ref: ./summary/models/dates.v1.yaml
     PatientSummary:
-      $ref: './clinic/models/summaries/patientsummary.v1.yaml'
+      $ref: ./clinic/models/summaries/patientsummary.v1.yaml
     UpdateTier:
       title: UpdateTier
       type: object

From 88afba8ae345552363526e5a2fa2fb50d54e94d5 Mon Sep 17 00:00:00 2001
From: clintonium-119 <clint.beacock@gmail.com>
Date: Mon, 26 Jun 2023 10:01:04 -0400
Subject: [PATCH 2/2] Update descriptions of new bulk tag ops endpoints

---
 reference/clinic.v1.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml
index 2f4f4039..9b4f0cf3 100644
--- a/reference/clinic.v1.yaml
+++ b/reference/clinic.v1.yaml
@@ -1228,7 +1228,7 @@ paths:
       summary: Assign Patient Tag To Clinic Patients
       operationId: AssignPatientTagToClinicPatients
       requestBody:
-        description: Pass an array of patient IDs to target a subset of the clinic patients. Omit request body to target all clinic patients.
+        description: Array of clinic patient user IDs to target for tag assignment.
         content:
           application/json:
             schema:
@@ -1236,7 +1236,7 @@ paths:
       responses:
         '200':
           description: OK
-      description: Assign a patient tag to all or a subset of clinic patients
+      description: Assign a patient tag to a subset of clinic patients
       tags:
         - Clinics
         - Internal