diff --git a/plugins/chain_api_plugin/chain.swagger.yaml b/plugins/chain_api_plugin/chain.swagger.yaml
index 66671e213af..88c055332ac 100644
--- a/plugins/chain_api_plugin/chain.swagger.yaml
+++ b/plugins/chain_api_plugin/chain.swagger.yaml
@@ -528,7 +528,7 @@ paths:
 
   /abi_json_to_bin:
     post:
-      description: Returns an object containing rows from the specified table.
+      description: Returns an object containing the serialized action data.
       operationId: abi_json_to_bin
       requestBody:
         content:
@@ -536,9 +536,17 @@ paths:
             schema:
               type: object
               title: AbiJsonToBinRequest
+                - code
+                - action
+                - args
               properties:
-                binargs:
-                  $ref: "https://eosio.github.io/schemata/v2.0/oas/Hex.yaml"
+                code:
+                  $ref: "https://eosio.github.io/schemata/v2.0/oas/Name.yaml"
+                action:
+                  $ref: "https://eosio.github.io/schemata/v2.0/oas/Name.yaml"
+                args:
+                  type: object
+                  description: json object of the action parameters that will be serialized.
 
       responses:
         "200":
@@ -553,7 +561,7 @@ paths:
 
   /abi_bin_to_json:
     post:
-      description: Returns an object containing rows from the specified table.
+      description: Returns an object containing the deserialized action data.
       operationId: abi_bin_to_json
       requestBody:
         content:
@@ -561,6 +569,10 @@ paths:
             schema:
               type: object
               title: AbiBinToJsonRequest
+              required:
+                - code
+                - action
+                - binargs
               properties:
                 code:
                   $ref: "https://eosio.github.io/schemata/v2.0/oas/Name.yaml"
@@ -578,7 +590,7 @@ paths:
 
   /get_code:
     post:
-      description: Returns an object containing rows from the specified table.
+      description: Returns an object containing the smart contract WASM code.
       operationId: get_code
       requestBody:
         content:
@@ -617,7 +629,7 @@ paths:
 
   /get_raw_abi:
     post:
-      description: Returns an object containing rows from the specified table.
+      description: Returns an object containing the smart contract abi.
       operationId: get_raw_abi
       requestBody:
         content: