Update organization details

Nictiz · Jul 18, 2024 · a221241 · a221241
1 parent f3dbbc3
commit a221241
Show file tree

Hide file tree

Showing 8 changed files with 37 additions and 24 deletions.
diff --git a/docs/learn/adding-an-api-specification.md b/docs/learn/adding-an-api-specification.md
@@ -128,8 +128,8 @@ is recorded into your history.
 
 !!! info
 
-    Although you cannot alter a submitted declaration, you can always add new declarations to reflect updates or changes.
-    The most recently submitted declaration will be used to display your ranking levels in the
+    Although you cannot alter a submitted declaration, you can always add new declarations to reflect updates or
+    changes. The most recently submitted declaration will be used to display your ranking levels in the
     [API Library for Dutch Healthcare](https://www.zorgapis.nl/){: target="_blank" }.
 
 ### Providing evidence

diff --git a/docs/learn/adding-an-organization.md b/docs/learn/adding-an-organization.md
@@ -2,6 +2,15 @@
 
 ## Add organization
 
+This section guides you through the process of adding your organization to the [API Library for Dutch Healthcare](
+https://www.zorgapis.nl/){: target="_blank" } via our API.
+
+!!! info
+
+    You can set the URL of your organization on GitHub or GitLab using the `githubUrl` and `gitlabUrl` properties. This
+    URL will be used to retrieve the organization's avatar and display it on the organization page in the API Library
+    for Dutch Healthcare.
+
 === "Request"
 
     ```json
@@ -12,6 +21,8 @@
     ```
 
     1.  The name of the organization, must be **unique**.
+    2.  The URL of the organization on GitHub. For GitLab, use the `gitlabUrl` property.
+    3.  To set the house number addition (for example, 'A'), use the `houseNumberAddition` property.
 
 === "Response"
 

diff --git a/docs/learn/snippets/accept-pending-invitation_response.json b/docs/learn/snippets/accept-pending-invitation_response.json
@@ -3,7 +3,7 @@
   "organizationId": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
   "organization": {
     "id": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
-    "name": "Stichting MedMij"
+    "name": "Nictiz"
   },
   "emailAddress": "[email protected]",
   "status": "ACCEPTED",

diff --git a/docs/learn/snippets/add-api-specification_response.json b/docs/learn/snippets/add-api-specification_response.json
@@ -6,7 +6,7 @@
   "organizationId": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
   "organization": {
     "id": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
-    "name": "Stichting MedMij"
+    "name": "Nictiz"
   },
   "architecturalStyle": "REST"
 }
diff --git a/docs/learn/snippets/add-organization_request.json b/docs/learn/snippets/add-organization_request.json
@@ -1,14 +1,15 @@
 {
-  "name": "Stichting MedMij", // (1)!
-  "description": "MedMij is the standard in the Netherlands for the secure exchange of health data between care users and care providers.",
-  "website": "https://medmij.nl/",
-  "emailAddress": "[email protected]",
-  "phoneNumber": "+31 (0)85 303 4959",
+  "name": "Nictiz", // (1)!
+  "description": "Nictiz is the Dutch competence center for electronic exchange of health and care information.",
+  "website": "https://nictiz.nl/",
+  "githubUrl": "https://github.com/Nictiz", // (2)!
+  "emailAddress": "[email protected]",
+  "phoneNumber": "+31 (0)70 317 3450",
   "address": {
-    "street": "Maanweg",
-    "houseNumber": 174,
-    "addressLine2": "Building C/3rd floor",
-    "postalCode": "2516 AB",
+    "street": "Oude Middenweg",
+    "houseNumber": 55, // (3)!
+    "addressLine2": "Office building Palazzo Giardino",
+    "postalCode": "2491 AC",
     "city": "The Hague",
     "stateOrRegion": "South Holland",
     "country": "NL"

diff --git a/docs/learn/snippets/add-organization_response.json b/docs/learn/snippets/add-organization_response.json
@@ -1,15 +1,16 @@
 {
   "id": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad", // (1)!
-  "name": "Stichting MedMij",
-  "description": "MedMij is the standard in the Netherlands for the secure exchange of health data between care users and care providers.",
-  "website": "https://medmij.nl/",
-  "emailAddress": "[email protected]",
-  "phoneNumber": "+31 (0)85 303 4959",
+  "name": "Nictiz",
+  "description": "Nictiz is the Dutch competence center for electronic exchange of health and care information.",
+  "website": "https://nictiz.nl/",
+  "githubUrl": "https://github.com/Nictiz",
+  "emailAddress": "[email protected]",
+  "phoneNumber": "+31 (0)70 317 3450",
   "address": {
-    "street": "Maanweg",
-    "houseNumber": 174,
-    "addressLine2": "Building C/3rd floor",
-    "postalCode": "2516 AB",
+    "street": "Oude Middenweg",
+    "houseNumber": 55,
+    "addressLine2": "Office building Palazzo Giardino",
+    "postalCode": "2491 AC",
     "city": "The Hague",
     "stateOrRegion": "South Holland",
     "country": "NL"

diff --git a/docs/learn/snippets/get-pending-invitations_response.json b/docs/learn/snippets/get-pending-invitations_response.json
@@ -4,7 +4,7 @@
     "organizationId": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
     "organization": {
       "id": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
-      "name": "Stichting MedMij"
+      "name": "Nictiz"
     },
     "emailAddress": "[email protected]",
     "status": "PENDING"

diff --git a/docs/learn/snippets/set-api-specification-main-version_response.json b/docs/learn/snippets/set-api-specification-main-version_response.json
@@ -6,7 +6,7 @@
   "organizationId": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
   "organization": {
     "id": "4a7c2c17-6514-46f8-aa05-6a22fb18b4ad",
-    "name": "Stichting MedMij"
+    "name": "Nictiz"
   },
   "architecturalStyle": "REST",
   "mainVersionId": "15261fd0-b292-45d9-b6b1-266cc922fb50",