NPA-4557: Add 5XX Error responses to OAS spec for POST Consent

Author: ellie-bound1-NHSD

…ent/errors/downstream-service-error.yaml …ses/errors/downstream-service-error.yamlspecification/examples/responses/GET_Consent/errors/downstream-service-error.yaml renamed to specification/examples/responses/errors/downstream-service-error.yaml specification/examples/responses/GET_Consent/errors/downstream-service-error.yaml renamed to specification/examples/responses/errors/downstream-service-error.yaml

@@ -491,7 +491,7 @@ paths:
                 InternalServerError:
                   $ref: "./examples/responses/errors/internal-server-error.yaml#/InternalServerError"
                 DownstreamServiceError:
-                  $ref: "./examples/responses/GET_Consent/errors/downstream-service-error.yaml#/DownstreamServiceError"
+                  $ref: "./examples/responses/errors/downstream-service-error.yaml#/DownstreamServiceError"
     post:
       summary: Create a proxy role
       description: |
@@ -577,7 +577,24 @@ paths:
                   $ref: "./examples/responses/POST_Consent/errors/invalid_patient_age_error.yaml#/PostConsentInvalidPatientAgeError"
                 postConsentDuplicateRelationship:
                   $ref: "./examples/responses/POST_Consent/errors/duplicate_relationship_error.yaml#/PostConsentDuplicateRelationshipError"
+        "5XX":
+          description: |
+            Errors will be returned for the first error encountered in the request. An error occurred as follows:
+
+            | HTTP status | Error code                 | Description                                                  |
+            | ----------- | -------------------------- | ------------------------------------------------------------ |
+            | 500         | `SERVER_ERROR`             | An unexpected internal server error has occurred.            |
+            | 503         | `DOWNSTREAM_SERVICE_ERROR` | A downsteam service has failed, request cannot be completed. |
 
+          content:
+            application/fhir+json:
+              schema:
+                $ref: "#/components/schemas/OperationOutcome"
+              examples:
+                InternalServerError:
+                  $ref: "./examples/responses/errors/internal-server-error.yaml#/InternalServerError"
+                DownstreamServiceError:
+                  $ref: "./examples/responses/errors/downstream-service-error.yaml#/DownstreamServiceError"
 
   /Consent/{id}:
     patch: