From 8ef34d95b1d414795544541d67e4ef4fa707b2e5 Mon Sep 17 00:00:00 2001
From: Reinier Zwitserloot <reinier@zwitserloot.com>
Date: Wed, 29 Jul 2026 03:34:01 +0200
Subject: [PATCH] [lint] Fixing warnings and errors.

---
 paths/patient_contactList.yaml | 24 +++++++++++++++++++++---
 zoo-api.yaml                   |  3 ++-
 2 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/paths/patient_contactList.yaml b/paths/patient_contactList.yaml
index 7306913..490128d 100644
--- a/paths/patient_contactList.yaml
+++ b/paths/patient_contactList.yaml
@@ -7,7 +7,7 @@ get:
   parameters: 
     - name: patUnids
       in: query
-      mandatory: true
+      required: true
       description: |-
         A comma separated list of patUnid values, as provided by other API endpoints.
         For each patUnid the contact details are in the response. If sending lots of patUnids, we suggest you call this API in a POST (which is also allowed, though the semantic intent of this method is GET: It only queries and makes no changes) to avoid HTTP limits on query length.
@@ -18,9 +18,27 @@ get:
         example: "1234,5678"
     - name: fields
       in: query
-      mandatory: true
+      required: true
+      schema:
+        type: array
+        items:
+          type: string
+          enum:
+            - bsn
+            - patPubId
+            - patUnid
+            - gender
+            - displayName
+            - fullName
+            - addressLine
+            - postcode
+            - city
+            - tel
+            - email
+            - dob
+      explode: false
       description: |-
-        Comma separated list of data fields that shold be returned in the response. Available options are:
+        Comma separated list of data fields that should be returned in the response. Available options are:
         bsn         - adds CSV column/JSON key 'bsn'.
         patPubId    - adds CSV column/JSON key 'patPubId'.
         patUnid     - adds CSV column/JSON key 'patUnid'.
diff --git a/zoo-api.yaml b/zoo-api.yaml
index 2efd864..8328fd3 100644
--- a/zoo-api.yaml
+++ b/zoo-api.yaml
@@ -42,7 +42,9 @@ tags:
       As well as a 'config' view where they see _all_ care programs that could possibly be relevant for that customer, where the customer can preview the report (essentially, run the report as normal), favourite something they don't get by default, or unfavourite something they get by default.
   - name: Customer management
     description: |-
+      Update and query properties of ZOO customers (such as who is the contact person and which care programs they participate in).
   - name: EPD exports
+    description: |-
       List and download exported parts of EPD (General Practioner Information Systems) dossiers.
 paths:
   /patient/dossier:
@@ -238,7 +240,6 @@ components:
       description: Indicated practice is known but has not authorized ZOO to share this information with signer.
   securitySchemes:
     BearerAuth:
-      in: header
       type: http
       scheme: bearer
       bearerFormat: JWT