[CMX-4574] - Update docs

spec/openapi.yaml

@@ -6417,13 +6417,21 @@ components:
           type: string
           example: "+61555555555"
         metadata_key:
-          description: Filter results for messages that include a metadata key.
+          description: Filter results for messages that include a metadata key. Can be used independently for searching.
           type: string
           example: broadcastId
         metadata_value:
-          description: Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided.
+          description: Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided. Cannot be used together with metadata_values.
           type: string
           example: ABC
+        metadata_values:
+          description: Filter results for messages that include a metadata key containing these values. Must be used together with metadata_key. Cannot be used together with metadata_value.
+          type: array
+          items:
+            type: string
+          example:
+            - meta1
+            - meta2
         accounts:
           description: >-
             Filter results by a specific account. By default results
@@ -6485,13 +6493,21 @@ components:
           type: string
           example: "+61555555555"
         metadata_key:
-          description: Filter results for messages that include a metadata key.
+          description: Filter results for messages that include a metadata key. Can be used independently for searching.
           type: string
           example: broadcastId
         metadata_value:
-          description: Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided.
+          description: Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided. Cannot be used together with metadata_values.
           type: string
           example: ABC
+        metadata_values:
+          description: Filter results for messages that include a metadata key containing these values. Must be used together with metadata_key. Cannot be used together with metadata_value.
+          type: array
+          items:
+            type: string
+          example:
+            - meta1
+            - meta2
         accounts:
           description: >-
             Filter results by a specific account. By default results
@@ -6590,13 +6606,21 @@ components:
             - "+61555555555"
             - "+614987654321"
         metadata_key:
-          description: Filter results for messages that include a metadata key.
+          description: Filter results for messages that include a metadata key. Can be used independently for searching.
           type: string
           example: broadcastId
         metadata_value:
-          description: Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided.
+          description: Filter results for messages that include a metadata key containing this value. If this parameter is provided, the metadata_key parameter must also be provided. Cannot be used together with metadata_values.
           type: string
           example: ABC
+        metadata_values:
+          description: Filter results for messages that include a metadata key containing these values. Must be used together with metadata_key. Cannot be used together with metadata_value.
+          type: array
+          items:
+            type: string
+          example:
+            - meta1
+            - meta2
         accounts:
           description: >-
             Filter results by a specific account. By default results