From 6278347ee5d82a2edd30c77be8616fbb8fbd6544 Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Tue, 22 Apr 2025 14:16:44 -0600 Subject: [PATCH 1/9] clinic sites Update: re-based on top of the redocly changes. Update: re-based on top of changes to remove ordering facility matching BACK-3634 --- reference/clinic.v1.yaml | 96 ++++++++++++++++++++ reference/clinic/models/clinic.v1.yaml | 4 + reference/clinic/models/clinicSite.v1.yaml | 3 + reference/clinic/models/patient.v1.yaml | 6 ++ reference/clinic/models/site.v1.yaml | 22 +++++ reference/clinic/models/siteCreation.v1.yaml | 13 +++ reference/clinic/models/siteId.v1.yaml | 9 ++ reference/clinic/models/siteIds.v1.yaml | 13 +++ reference/clinic/models/sitePatients.v1.yaml | 13 +++ reference/clinic/parameters/siteId.v1.yaml | 7 ++ 10 files changed, 186 insertions(+) create mode 100644 reference/clinic/models/clinicSite.v1.yaml create mode 100644 reference/clinic/models/site.v1.yaml create mode 100644 reference/clinic/models/siteCreation.v1.yaml create mode 100644 reference/clinic/models/siteId.v1.yaml create mode 100644 reference/clinic/models/siteIds.v1.yaml create mode 100644 reference/clinic/models/sitePatients.v1.yaml create mode 100644 reference/clinic/parameters/siteId.v1.yaml diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index 26d707f4..998077fb 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -908,6 +908,16 @@ paths: description: Comma-separated list of patient tag IDs style: form explode: false + - name: sites + schema: + type: array + items: + type: string + format: '^[a-f0-9]{24}$' + in: query + description: Comma-separated list of clinic site IDs + style: form + explode: false description: Retrieve a list of patients of a clinic post: summary: Create Patient Account @@ -944,6 +954,75 @@ paths: $ref: '#/components/schemas/patientTag.v1' tags: - Clinics + '/v1/clinics/{clinicId}/sites': + parameters: + - $ref: '#/components/parameters/clinicId' + get: + summary: List Sites + operationId: ListSites + responses: + '200': + description: List of clinic sites + content: + application/json: + schema: + $ref: '#/components/schemas/clinicSites.v1' + description: List sites + tags: + - Clinics + post: + summary: Create a Site + operationId: CreateSite + responses: + '200': + description: List of clinic sites + content: + application/json: + schema: + $ref: '#/components/schemas/clinicSites.v1' + description: Create a Site + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/siteCreation.v1' + tags: + - Clinics + '/v1/clinics/{clinicId}/sites/{siteId}': + parameters: + - $ref: '#/components/parameters/clinicId' + - $ref: '#/components/parameters/siteId' + put: + summary: Update a Site + operationId: UpdateSite + responses: + '200': + description: List of clinic sites + content: + application/json: + schema: + $ref: '#/components/schemas/clinicSites.v1' + description: Update a Site + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/site.v1' + tags: + - Clinics + delete: + summary: Delete a Site + operationId: DeleteSite + responses: + '200': + description: List of clinic sites + content: + application/json: + schema: + $ref: '#/components/schemas/clinicSites.v1' + description: 'Delete a Site' + tags: + - Clinics '/v1/clinics/{clinicId}/clinicians/{clinicianId}': parameters: - $ref: '#/components/parameters/clinicId' @@ -2167,6 +2246,14 @@ components: type: array items: $ref: ./clinic/models/dataSource.v1.yaml + clinicSites.v1: + type: array + items: + $ref: ./clinic/models/clinicSite.v1.yaml + site.v1: + $ref: ./clinic/models/site.v1.yaml + siteCreation.v1: + $ref: ./clinic/models/siteCreation.v1.yaml tidepoolUserIds.v1: type: array nullable: true @@ -2218,6 +2305,8 @@ components: minLength: 1 tags: $ref: ./clinic/models/patientTagIds.v1.yaml + siteIds: + $ref: ./clinic/models/siteIds.v1.yaml associateClinicianToUser.v1: title: Associate Clinician type: object @@ -2530,6 +2619,13 @@ components: schema: type: string pattern: '^[a-f0-9]{24}$' + siteId: + name: siteId + in: path + required: true + schema: + type: string + pattern: '^[a-f0-9]{24}$' userId: name: userId in: path diff --git a/reference/clinic/models/clinic.v1.yaml b/reference/clinic/models/clinic.v1.yaml index d6eafa27..9aa65045 100644 --- a/reference/clinic/models/clinic.v1.yaml +++ b/reference/clinic/models/clinic.v1.yaml @@ -18,6 +18,10 @@ properties: type: array items: $ref: ./patientTag.v1.yaml + sites: + type: array + items: + $ref: ./clinicSite.v1.yaml lastDeletedPatientTag: $ref: ./patientTag.v1.yaml phoneNumbers: diff --git a/reference/clinic/models/clinicSite.v1.yaml b/reference/clinic/models/clinicSite.v1.yaml new file mode 100644 index 00000000..7ba0f7c0 --- /dev/null +++ b/reference/clinic/models/clinicSite.v1.yaml @@ -0,0 +1,3 @@ +allOf: + - $ref: ./site.v1.yaml + - $ref: ./sitePatients.v1.yaml diff --git a/reference/clinic/models/patient.v1.yaml b/reference/clinic/models/patient.v1.yaml index 6d53d87a..c50b9c5b 100644 --- a/reference/clinic/models/patient.v1.yaml +++ b/reference/clinic/models/patient.v1.yaml @@ -61,6 +61,12 @@ properties: id: 502rliv0l2tyy description: Requests for each provider are listed in reverse chronological order readOnly: true + sites: + type: array + nullable: true + x-go-type-skip-optional-pointer: true + items: + $ref: ./site.v1.yaml required: - id - fullName diff --git a/reference/clinic/models/site.v1.yaml b/reference/clinic/models/site.v1.yaml new file mode 100644 index 00000000..ed5996a1 --- /dev/null +++ b/reference/clinic/models/site.v1.yaml @@ -0,0 +1,22 @@ +type: object +title: Site +description: "A clinic's physical or logical location." +properties: + id: + title: Object Id + type: string + x-go-type-skip-optional-pointer: true + description: String representation of a resource id + minLength: 24 + maxLength: 24 + pattern: '^[a-f0-9]{24}$' + name: + type: string + x-go-type-skip-optional-pointer: true + description: The site description. + minLength: 1 + maxLength: 200 + pattern: '^[[:graph:]\p{L}\p{N}][[:graph:]\p{L}\p{N} ]*$' +required: + - id + - name diff --git a/reference/clinic/models/siteCreation.v1.yaml b/reference/clinic/models/siteCreation.v1.yaml new file mode 100644 index 00000000..7d00d2a0 --- /dev/null +++ b/reference/clinic/models/siteCreation.v1.yaml @@ -0,0 +1,13 @@ +type: object +title: Site +description: "A clinic's physical or logical location." +properties: + name: + type: string + x-go-type-skip-optional-pointer: true + description: The site description. + minLength: 1 + maxLength: 200 + pattern: '^[[:graph:]\p{L}\p{N}][[:graph:]\p{L}\p{N} ]*$' +required: + - name diff --git a/reference/clinic/models/siteId.v1.yaml b/reference/clinic/models/siteId.v1.yaml new file mode 100644 index 00000000..6c42cdda --- /dev/null +++ b/reference/clinic/models/siteId.v1.yaml @@ -0,0 +1,9 @@ +title: Site ID +description: >- + Site identifier. +type: string +minLength: 24 +maxLength: 24 +pattern: '^[a-f0-9]{24}$' +readOnly: true +example: 2fe2488217ee43e1b2e83c2f diff --git a/reference/clinic/models/siteIds.v1.yaml b/reference/clinic/models/siteIds.v1.yaml new file mode 100644 index 00000000..3ebf0c1e --- /dev/null +++ b/reference/clinic/models/siteIds.v1.yaml @@ -0,0 +1,13 @@ +type: array +title: Site ID List +uniqueItems: true +nullable: true +items: + title: Site ID + description: >- + Site identifier. + type: string + minLength: 24 + maxLength: 24 + pattern: '^[a-f0-9]{24}$' + readOnly: true diff --git a/reference/clinic/models/sitePatients.v1.yaml b/reference/clinic/models/sitePatients.v1.yaml new file mode 100644 index 00000000..ad6b084d --- /dev/null +++ b/reference/clinic/models/sitePatients.v1.yaml @@ -0,0 +1,13 @@ +# sitepatients extends site with the clinic-specific patient count +type: object +title: Site Patients +description: Site properties specific to a clinic. +properties: + patients: + type: integer + x-go-type-skip-optional-pointer: true + description: The number of patients associated with the site. + readOnly: true + minimum: 0 +required: + - patients diff --git a/reference/clinic/parameters/siteId.v1.yaml b/reference/clinic/parameters/siteId.v1.yaml new file mode 100644 index 00000000..c603cb89 --- /dev/null +++ b/reference/clinic/parameters/siteId.v1.yaml @@ -0,0 +1,7 @@ +description: >- + Site ID +name: siteId +in: path +required: true +schema: + $ref: '../models/siteid.v1.yaml' From cd11077a5a30332b47529891228e0ab91bfa694a Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Wed, 30 Jul 2025 14:30:39 -0600 Subject: [PATCH 2/9] revert sites endpoints that return lists of sites After discussion with the team, we will: - no longer have a GET endpoint to list clinic sites - sites creation/update/deletion will no longer return a list of sites - site creation/update will return only the affected site BACK-3632 --- reference/clinic.v1.yaml | 29 ++++++----------------------- 1 file changed, 6 insertions(+), 23 deletions(-) diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index 998077fb..2b35bc4a 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -957,29 +957,16 @@ paths: '/v1/clinics/{clinicId}/sites': parameters: - $ref: '#/components/parameters/clinicId' - get: - summary: List Sites - operationId: ListSites - responses: - '200': - description: List of clinic sites - content: - application/json: - schema: - $ref: '#/components/schemas/clinicSites.v1' - description: List sites - tags: - - Clinics post: summary: Create a Site operationId: CreateSite responses: '200': - description: List of clinic sites + description: The newly-created clinic site content: application/json: schema: - $ref: '#/components/schemas/clinicSites.v1' + $ref: ./clinic/models/clinicSite.v1.yaml description: Create a Site requestBody: content: @@ -997,11 +984,11 @@ paths: operationId: UpdateSite responses: '200': - description: List of clinic sites + description: The updated clinic site content: application/json: schema: - $ref: '#/components/schemas/clinicSites.v1' + $ref: ./clinic/models/clinicSite.v1.yaml description: Update a Site requestBody: content: @@ -1014,12 +1001,8 @@ paths: summary: Delete a Site operationId: DeleteSite responses: - '200': - description: List of clinic sites - content: - application/json: - schema: - $ref: '#/components/schemas/clinicSites.v1' + '204': + description: No content description: 'Delete a Site' tags: - Clinics From c285dd3321715e7c2cdcc5a28f04f83e8a88f70d Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Wed, 30 Jul 2025 14:34:48 -0600 Subject: [PATCH 3/9] revert patient tags endpoints that return lists of patient tags After discussion with the team, we will: - no longer have a GET endpoint to list patient tags - patient tags creation/update/deletion will no longer return a list of tags - patient tags creation/update will return only the affected tag BACK-3632 --- reference/clinic.v1.yaml | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index 2b35bc4a..337bc00a 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -945,7 +945,11 @@ paths: operationId: CreatePatientTag responses: '200': - description: OK + description: The newly-created patient tag + content: + application/json: + schema: + $ref: ./clinic/models/patientTag.v1.yaml description: Create a new patient tag requestBody: content: @@ -1117,7 +1121,11 @@ paths: operationId: UpdatePatientTag responses: '200': - description: OK + description: The updated patient tag + content: + application/json: + schema: + $ref: ./clinic/models/patientTag.v1.yaml description: Update existing patient tag tags: - Clinics @@ -1130,8 +1138,8 @@ paths: summary: Delete Patient Tag operationId: DeletePatientTag responses: - '200': - description: OK + '204': + description: No content description: Removes a patient tag from a clinic and tagged patients tags: - Clinics From b8d1d34955c613322fc0db353a9cfe119d4e2274 Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Fri, 1 Aug 2025 16:53:21 -0600 Subject: [PATCH 4/9] sites passed at patient creation should include name and id BACK-3632 --- reference/clinic.v1.yaml | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index 337bc00a..bfeec243 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -2296,8 +2296,10 @@ components: minLength: 1 tags: $ref: ./clinic/models/patientTagIds.v1.yaml - siteIds: - $ref: ./clinic/models/siteIds.v1.yaml + sites: + type: array + items: + $ref: ./clinic/models/site.v1.yaml associateClinicianToUser.v1: title: Associate Clinician type: object @@ -2489,6 +2491,10 @@ components: minLength: 1 tags: $ref: ./clinic/models/patientTagIds.v1.yaml + sites: + type: array + items: + $ref: ./clinic/models/clinicSite.v1.yaml addServiceAccount.v1: title: AddServiceAccount x-stoplight: From 75ab9b0c105ede485e1f803907aa5752993bdc1c Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Mon, 11 Aug 2025 08:57:49 -0600 Subject: [PATCH 5/9] sites in patients shouldn't be a pointer to a slice BACK-3632 --- reference/clinic.v1.yaml | 2 ++ reference/clinic/models/clinic.v1.yaml | 1 + reference/clinic/models/patient.v1.yaml | 1 - 3 files changed, 3 insertions(+), 1 deletion(-) diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index bfeec243..a49dbac6 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -2298,6 +2298,7 @@ components: $ref: ./clinic/models/patientTagIds.v1.yaml sites: type: array + x-go-type-skip-optional-pointer: true items: $ref: ./clinic/models/site.v1.yaml associateClinicianToUser.v1: @@ -2493,6 +2494,7 @@ components: $ref: ./clinic/models/patientTagIds.v1.yaml sites: type: array + x-go-type-skip-optional-pointer: true items: $ref: ./clinic/models/clinicSite.v1.yaml addServiceAccount.v1: diff --git a/reference/clinic/models/clinic.v1.yaml b/reference/clinic/models/clinic.v1.yaml index 9aa65045..be591076 100644 --- a/reference/clinic/models/clinic.v1.yaml +++ b/reference/clinic/models/clinic.v1.yaml @@ -20,6 +20,7 @@ properties: $ref: ./patientTag.v1.yaml sites: type: array + x-go-type-skip-optional-pointer: true items: $ref: ./clinicSite.v1.yaml lastDeletedPatientTag: diff --git a/reference/clinic/models/patient.v1.yaml b/reference/clinic/models/patient.v1.yaml index c50b9c5b..c1ea08f4 100644 --- a/reference/clinic/models/patient.v1.yaml +++ b/reference/clinic/models/patient.v1.yaml @@ -63,7 +63,6 @@ properties: readOnly: true sites: type: array - nullable: true x-go-type-skip-optional-pointer: true items: $ref: ./site.v1.yaml From 9af9592ba5aef5d0181535c01ccad74d8660fd7d Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Mon, 11 Aug 2025 13:25:07 -0600 Subject: [PATCH 6/9] use new x-omitzero from oapi-codegen for clinic sites BACK-3632 --- reference/clinic.v1.yaml | 4 ++++ reference/clinic/models/patient.v1.yaml | 2 ++ 2 files changed, 6 insertions(+) diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index a49dbac6..75fd5ddd 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -2299,6 +2299,8 @@ components: sites: type: array x-go-type-skip-optional-pointer: true + x-omitempty: false + x-omitzero: true items: $ref: ./clinic/models/site.v1.yaml associateClinicianToUser.v1: @@ -2495,6 +2497,8 @@ components: sites: type: array x-go-type-skip-optional-pointer: true + x-omitempty: false + x-omitzero: true items: $ref: ./clinic/models/clinicSite.v1.yaml addServiceAccount.v1: diff --git a/reference/clinic/models/patient.v1.yaml b/reference/clinic/models/patient.v1.yaml index c1ea08f4..8ae862fe 100644 --- a/reference/clinic/models/patient.v1.yaml +++ b/reference/clinic/models/patient.v1.yaml @@ -64,6 +64,8 @@ properties: sites: type: array x-go-type-skip-optional-pointer: true + x-omitempty: false + x-omitzero: true items: $ref: ./site.v1.yaml required: From 888e079bc04b127be12d55d2183c1800e7790609 Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Thu, 14 Aug 2025 09:57:22 -0600 Subject: [PATCH 7/9] removes patient counts from sites The requirement for having patient counts in the returned sites was removed, and since the implementation was clunky, removing it for now seems optimal. BACK-3632 --- reference/clinic.v1.yaml | 10 +++------- reference/clinic/models/clinic.v1.yaml | 2 +- reference/clinic/models/clinicSite.v1.yaml | 3 --- reference/clinic/models/sitePatients.v1.yaml | 13 ------------- 4 files changed, 4 insertions(+), 24 deletions(-) delete mode 100644 reference/clinic/models/clinicSite.v1.yaml delete mode 100644 reference/clinic/models/sitePatients.v1.yaml diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index 75fd5ddd..c161f7ab 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -970,7 +970,7 @@ paths: content: application/json: schema: - $ref: ./clinic/models/clinicSite.v1.yaml + $ref: ./clinic/models/site.v1.yaml description: Create a Site requestBody: content: @@ -992,7 +992,7 @@ paths: content: application/json: schema: - $ref: ./clinic/models/clinicSite.v1.yaml + $ref: ./clinic/models/site.v1.yaml description: Update a Site requestBody: content: @@ -2237,10 +2237,6 @@ components: type: array items: $ref: ./clinic/models/dataSource.v1.yaml - clinicSites.v1: - type: array - items: - $ref: ./clinic/models/clinicSite.v1.yaml site.v1: $ref: ./clinic/models/site.v1.yaml siteCreation.v1: @@ -2500,7 +2496,7 @@ components: x-omitempty: false x-omitzero: true items: - $ref: ./clinic/models/clinicSite.v1.yaml + $ref: ./clinic/models/site.v1.yaml addServiceAccount.v1: title: AddServiceAccount x-stoplight: diff --git a/reference/clinic/models/clinic.v1.yaml b/reference/clinic/models/clinic.v1.yaml index be591076..2b71be51 100644 --- a/reference/clinic/models/clinic.v1.yaml +++ b/reference/clinic/models/clinic.v1.yaml @@ -22,7 +22,7 @@ properties: type: array x-go-type-skip-optional-pointer: true items: - $ref: ./clinicSite.v1.yaml + $ref: ./site.v1.yaml lastDeletedPatientTag: $ref: ./patientTag.v1.yaml phoneNumbers: diff --git a/reference/clinic/models/clinicSite.v1.yaml b/reference/clinic/models/clinicSite.v1.yaml deleted file mode 100644 index 7ba0f7c0..00000000 --- a/reference/clinic/models/clinicSite.v1.yaml +++ /dev/null @@ -1,3 +0,0 @@ -allOf: - - $ref: ./site.v1.yaml - - $ref: ./sitePatients.v1.yaml diff --git a/reference/clinic/models/sitePatients.v1.yaml b/reference/clinic/models/sitePatients.v1.yaml deleted file mode 100644 index ad6b084d..00000000 --- a/reference/clinic/models/sitePatients.v1.yaml +++ /dev/null @@ -1,13 +0,0 @@ -# sitepatients extends site with the clinic-specific patient count -type: object -title: Site Patients -description: Site properties specific to a clinic. -properties: - patients: - type: integer - x-go-type-skip-optional-pointer: true - description: The number of patients associated with the site. - readOnly: true - minimum: 0 -required: - - patients From 0ff0c4dc5900ce59dd6174ccbfc40b448333b3b7 Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Fri, 29 Aug 2025 10:36:57 -0600 Subject: [PATCH 8/9] add a site merge endpoint for clinics BACK-3978 --- reference/clinic.v1.yaml | 22 ++++++++++++++++++++++ reference/clinic/models/siteById.v1.yaml | 8 ++++++++ 2 files changed, 30 insertions(+) create mode 100644 reference/clinic/models/siteById.v1.yaml diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index c161f7ab..4f828714 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -1010,6 +1010,28 @@ paths: 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' diff --git a/reference/clinic/models/siteById.v1.yaml b/reference/clinic/models/siteById.v1.yaml new file mode 100644 index 00000000..f9e746de --- /dev/null +++ b/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 From 139f95eaad86fa31fb5c751ac871fbf605527561 Mon Sep 17 00:00:00 2001 From: Eric Wollesen Date: Fri, 29 Aug 2025 14:29:38 -0600 Subject: [PATCH 9/9] add a patient tag to site conversion endpoint BACK-3978 --- reference/clinic.v1.yaml | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/reference/clinic.v1.yaml b/reference/clinic.v1.yaml index 4f828714..65dafc32 100644 --- a/reference/clinic.v1.yaml +++ b/reference/clinic.v1.yaml @@ -1165,6 +1165,25 @@ paths: 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'