NPA-4610 Add Replace Legal Basis Example

Author: JackPlowman

specification/examples/requests/PATCH_Consent/replace_legal_basis.yaml

@@ -0,0 +1,17 @@
+ReplaceLegalBasisRequest:
+  summary: Replace legal basis
+  description: payload used to replace the legal basis of a consent resource
+  value:
+    - op: replace
+      path: /provision/actor
+      value:
+        - role:
+            coding:
+              - system: http://terminology.hl7.org/CodeSystem/v3-RoleCode
+                code: GUARD
+                display: Guardian
+          reference:
+            type: RelatedPerson
+            identifier:
+              system: https://fhir.nhs.uk/Id/nhs-number
+              value: "9000000017"

specification/validated-relationships-service-api.yaml

@@ -781,7 +781,8 @@ paths:
                   - op: replace
                     path: /provision/period/end
                     value: "2026-12-31"
-
+              replaceLegalBasis:
+                $ref: "./examples/requests/PATCH_Consent/replace_legal_basis.yaml#/ReplaceLegalBasisRequest"
       responses:
         "200":
           description: Consent resource successfully updated