diff --git a/jsonrpc/src/methods/beacon.json b/jsonrpc/src/methods/beacon.json
index 0b19d64..226bc38 100644
--- a/jsonrpc/src/methods/beacon.json
+++ b/jsonrpc/src/methods/beacon.json
@@ -99,7 +99,7 @@
   },
   {
     "name": "portal_beaconOffer",
-    "summary": "Send an OFFER request with given ContentKey, to the designated peer and wait for a response.",
+    "summary": "Send an OFFER request with given array of Content Pairs (Keys & Values), to the designated peer and wait for a response. `portal_historyOffer` should only accept 1 to 64 content pairs else the client will throw an out of bounds error.",
     "params": [
       {
         "$ref": "#/components/contentDescriptors/Enr"
diff --git a/jsonrpc/src/methods/history.json b/jsonrpc/src/methods/history.json
index cdf9928..87cdb83 100644
--- a/jsonrpc/src/methods/history.json
+++ b/jsonrpc/src/methods/history.json
@@ -99,7 +99,7 @@
   },
   {
     "name": "portal_historyOffer",
-    "summary": "Send an OFFER request with given ContentKey, to the designated peer and wait for a response.",
+    "summary": "Send an OFFER request with given array of Content Pairs (Keys & Values), to the designated peer and wait for a response. `portal_historyOffer` should only accept 1 to 64 content pairs else the client will throw an out of bounds error.",
     "params": [
       {
         "$ref": "#/components/contentDescriptors/Enr"
diff --git a/jsonrpc/src/methods/state.json b/jsonrpc/src/methods/state.json
index 1197929..ca03796 100644
--- a/jsonrpc/src/methods/state.json
+++ b/jsonrpc/src/methods/state.json
@@ -99,7 +99,7 @@
   },
   {
     "name": "portal_stateOffer",
-    "summary": "Send an OFFER request with given ContentKey, to the designated peer and wait for a response.",
+    "summary": "Send an OFFER request with given array of Content Pairs (Keys & Values), to the designated peer and wait for a response. `portal_historyOffer` should only accept 1 to 64 content pairs else the client will throw an out of bounds error.",
     "params": [
       {
         "$ref": "#/components/contentDescriptors/Enr"