Add Code Snippets to Spec Files

Author: DX-Bandwidth

site/specs/messaging.yml

@@ -887,6 +887,7 @@ paths:
         - $ref: '#/components/parameters/sort'
         - $ref: '#/components/parameters/pageToken'
         - $ref: '#/components/parameters/limit'
+        - $ref: '#/components/parameters/trackTotalCount'
       responses:
         '200':
           $ref: '#/components/responses/listMessagesResponse'
@@ -1529,6 +1530,18 @@ components:
       schema:
         type: integer
       example: 50
+    trackTotalCount:
+      in: query
+      name: trackTotalCount
+      required: false
+      default: true
+      description: >-
+        When set to false, the response's totalCount field will have a maximum
+        value of 10,000. When set to true, or excluded, this will give an
+        accurate totalCount of all messages that match the provided filters.
+      schema:
+        type: boolean
+      example: true
   schemas:
     priorityEnum:
       type: string
@@ -1593,7 +1606,10 @@ components:
       properties:
         totalCount:
           type: integer
-          description: Total number of messages matched by the search.
+          description: >-
+            The total count of objects returned in the response. When the
+            request has trackTotalCount set to false this value is limited to
+            10,000.
           example: 100
         pageInfo:
           $ref: '#/components/schemas/pageInfo'