add returnPresentation option to presentations/verify

components/VerifyPresentationOptions.yml

@@ -23,8 +23,12 @@ components:
         domain:
           type: string
           description: The intended domain of validity for the proof. For example website.example
+        returnPresentation:
+          type: boolean
+          description: Should the verified presentation be returned in the response? If true, then the verified presentation should be returned in the form in which it was verified. If false or not provided, then the verified presentation should not be returned.
       example:
         {
           "domain": "example.com",
-          "challenge": "d436f0c8-fbd9-4e48-bbb2-55fc5d0920a8"
+          "challenge": "d436f0c8-fbd9-4e48-bbb2-55fc5d0920a8",
+          "returnPresentation": true
         }

components/VerifyPresentationResult.yml

@@ -0,0 +1,38 @@
+openapi: 3.0.0
+info:
+  version: "0.0.3-unstable"
+  title: VC API
+  description: This is an Experimental Open API Specification for the [VC Data Model](https://www.w3.org/TR/vc-data-model/).
+  license:
+    name: W3C Software and Document License
+    url: http://www.w3.org/Consortium/Legal/copyright-software.
+  contact:
+    name: GitHub Source Code
+    url: https://github.com/w3c-ccg/vc-api
+paths:
+components:
+  schemas:
+    VerificationResult:
+      type: object
+      additionalProperties: false
+      description: Object summarizing a verification
+      properties:
+        checks:
+          type: array
+          description: The checks performed
+          items:
+            type: string
+        warnings:
+          type: array
+          description: Warnings
+          items:
+            type: string
+        errors:
+          type: array
+          description: Errors
+          items:
+            type: string
+        verifiedPresentation:
+          type: object
+          description: The verified presentation
+      example: { "checks": ["proof"], "warnings": [], "errors": [] }

verifier.yml

@@ -107,7 +107,7 @@ components:
         options:
           $ref: "./components/VerifyCredentialOptions.yml#/components/schemas/VerifyCredentialOptions"
     VerifyCredentialResponse:
-      $ref: "./components/VerificationResult.yml#/components/schemas/VerificationResult"
+      $ref: "./components/VerifyCredentialResult.yml#/components/schemas/VerificationResult"
     VerifyPresentationRequest:
       type: object
       properties:
@@ -121,6 +121,6 @@ components:
         presentation:
           $ref: "./components/Presentation.yml#/components/schemas/Presentation"
     VerifyPresentationResponse:
-      $ref: "./components/VerificationResult.yml#/components/schemas/VerificationResult"
+      $ref: "./components/VerifyPresentationResult.yml#/components/schemas/VerificationResult"
     CreateChallengeResponse:
       $ref: "./components/Challenge.yml#/components/schemas/CreateChallengeResult"