BB2-3986: Update v3 swagger for connectathon (#1354)

* First set of updates to swagger doc.

* update v3 yaml

* add service-date again

* remove startIndex from coverage

---------

Co-authored-by: jimmyfagan <jimmyfagan@navapbc.com>

Author: alex-dzeda

static/connectathon_openapi.yaml

@@ -38,7 +38,7 @@ paths:
                   $ref: '#/components/examples/OpenIdConfigurationExample'
           description: "OIDC Discovery: listing of the OpenID/OAuth endpoints, supported scopes and claims"
       tags:
-        - v2
+        - v3
 
   /v3/fhir/.well-known/smart-configuration:
     get:
@@ -118,7 +118,7 @@ paths:
         - name: resource_id
           in: path
           required: true
-          description: "Pateint FHIR resource id, e.g. -20140000000001 (synthetic beneficiary)"
+          description: "Patient FHIR resource id, e.g. -20140000000001 (synthetic beneficiary)"
           schema:
             type: string
       responses:
@@ -140,7 +140,7 @@ paths:
         '502':
           description: "Error: Bad Gateway, e.g. An error occurred contacting the FHIR server."
       tags:
-        - v2
+        - v3
   /v3/fhir/Patient/:
     get:
       operationId: listSearchViewPatients_v3
@@ -174,24 +174,6 @@ paths:
               - __lastUpdated=gt2023-01-02T00:00+00:00&\_lastUpdated=lt2023-05-01T00:00+00:00_ defines a range between two provided dates
               - __lastUpdated=gt2023-01-02T00:00+00:00_ defines a range between the provided date and today
               - __lastUpdated=lt2023-05-01T00:00+00:00_ defines a range from the earliest available records until the provided date
-        - in: query
-          name: startIndex
-          schema:
-            type: string
-          required: false
-          description: "The offset used for result pagination"
-        - in: query
-          name: _has:Coverage
-          schema:
-            type: string
-          required: false
-          description: "Part D coverage type/year"
-        - in: query
-          name: cursor
-          schema:
-            type: string
-          required: false
-          description: "The cursor used for result pagination"
         - in: query
           name: _id
           schema:
@@ -283,12 +265,6 @@ paths:
               - __lastUpdated=gt2023-01-02T00:00+00:00&\_lastUpdated=lt2023-05-01T00:00+00:00_ defines a range between two provided dates
               - __lastUpdated=gt2023-01-02T00:00+00:00_ defines a range between the provided date and today
               - __lastUpdated=lt2023-05-01T00:00+00:00_ defines a range from the earliest available records until the provided date
-        - in: query
-          name: startIndex
-          schema:
-            type: string
-          required: false
-          description: "The offset used for result pagination"
       responses:
         '200':
           content:
@@ -371,11 +347,18 @@ paths:
               - __lastUpdated=gt2023-01-02T00:00+00:00_ defines a range between the provided date and today
               - __lastUpdated=lt2023-05-01T00:00+00:00_ defines a range from the earliest available records until the provided date
         - in: query
-          name: excludeSAMHSA
+          name: _tag
           schema:
             type: string
           required: false
-          description: "If true, exclude all SAMHSA-related resources"
+          description: |-
+            For the Connectathon, _tag can be used to filter for partially-adjudicated vs. fully-adjudicated claims at query time.
+            Acceptable values for _tag are Adjudicated and PartiallyAdjudicated
+
+            Examples:
+              - __tag=Adjudicated_ defines a range between two provided dates
+              - __tag=PartiallyAdjudicated_ will only return partially-adjudicated claims
+              - both adjudicated and partially-adjudicated claims will be available by default (eg if _tag is not passed)
         - in: query
           name: service-date
           schema:
@@ -399,18 +382,6 @@ paths:
               - _service-date=gt2023-01-02T00:00+00:00&service-date=lt2023-05-01T00:00+00:00_ defines a range between two provided dates
               - _service-date=gt2023-01-02T00:00+00:00_ defines a range between the provided date and today
               - _service-date=lt2023-05-01T00:00+00:00_ defines a range from the earliest available records until the provided date
-        - in: query
-          name: startIndex
-          schema:
-            type: string
-          required: false
-          description: "The offset used for result pagination"
-        - in: query
-          name: type
-          schema:
-            type: string
-          required: false
-          description: "A list of claim types to include"
       responses:
         '200':
           content: