diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 60933f83ac..7a95c73f16 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -988,10 +988,50 @@ paths:
       parameters:
         - name: trait_abi
           in: query
-          description: JSON abi of the trait.
+          description: JSON stringified ABI object e.g. `JSON.stringify(abi)`.
           required: true
-          schema:
-            type: string
+          schema:  # The request schema
+              type: object  # JSON object type
+              properties:
+                functions:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      access:
+                        type: string
+                      args:
+                        type: array
+                        items: {}
+                      name:
+                        type: string
+                      outputs:
+                        type: object
+                        properties:
+                          type:
+                            type: object
+                            properties:
+                              response:
+                                type: object
+                                properties:
+                                  ok:
+                                    type: string
+                                    format: uint128
+                                  error:
+                                    type: string
+                                    format: uint128
+                variables:
+                  type: array
+                  items: {}
+                maps:
+                  type: array
+                  items: {}
+                fungible_tokens:
+                  type: array
+                  items: {}
+                non_fungible_tokens:
+                  type: array
+                  items: {}
         - name: limit
           in: query
           description: max number of contracts fetch