diff --git a/open-api/openapi.json b/open-api/openapi.json
index 7655cac58b..463eaf3bff 100644
--- a/open-api/openapi.json
+++ b/open-api/openapi.json
@@ -109,9 +109,10 @@
     }
   }, {
     "name" : "resolver",
-    "description" : "did resolver interface.",
+    "description" : "DID resolver interface",
     "externalDocs" : {
-      "description" : "Specification"
+      "description" : "Specification",
+      "url" : "https://github.com/hyperledger/aries-rfcs/tree/fa4b1947c6077168d2c69f45ed6bee2bb1eae4c8/features/0124-did-resolution-protocol"
     }
   }, {
     "name" : "revocation",
@@ -2442,8 +2443,7 @@
           "required" : false,
           "type" : "array",
           "items" : {
-            "type" : "string",
-            "description" : "Indicate terms to which the mediator requires the recipient to agree"
+            "type" : "string"
           },
           "collectionFormat" : "multi"
         }, {
@@ -2453,8 +2453,7 @@
           "required" : false,
           "type" : "array",
           "items" : {
-            "type" : "string",
-            "description" : "Indicate terms to which the recipient requires the mediator to agree"
+            "type" : "string"
           },
           "collectionFormat" : "multi"
         }, {