diff --git a/openapi.yml b/openapi.yml
index 21724d3..10466b7 100644
--- a/openapi.yml
+++ b/openapi.yml
@@ -2479,6 +2479,10 @@ components:
           description: Returned only for union query response.
           items:
             $ref: "#/components/schemas/SearchRequestParams"
+        metadata:
+          type: object
+          description: Custom JSON object that can be returned in the search response
+          additionalProperties: true
     SearchRequestParams:
       type: object
       required: