docs: Add cursor pagination to Data Connectors list endpoint

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ellicenelson

descriptions/0/api.intercom.io.yaml

@@ -10046,6 +10046,21 @@ paths:
         in: header
         schema:
           "$ref": "#/components/schemas/intercom_version"
+      - name: per_page
+        in: query
+        required: false
+        description: The number of results to return per page. Defaults to 20, minimum 1, maximum 50.
+        schema:
+          type: integer
+          default: 20
+          minimum: 1
+          maximum: 50
+      - name: starting_after
+        in: query
+        required: false
+        description: The cursor value from `pages.next.starting_after` in a previous response. Used to paginate through results.
+        schema:
+          type: string
       tags:
       - Data Connectors
       operationId: listDataConnectors
@@ -10054,6 +10069,8 @@ paths:
 
         Data connectors allow you to make HTTP requests to external APIs from Intercom workflows and AI agents.
         Each connector in the response includes an `execution_results_url` for navigating to its execution logs.
+
+        Results are ordered by `updated_at` descending and paginated using cursor-based pagination. Use the `starting_after` cursor from `pages.next` to fetch the next page. When `pages.next` is absent, you have reached the last page.
       responses:
         '200':
           description: successful
@@ -10070,12 +10087,33 @@ paths:
                       description: Posts conversation updates to Slack channel
                       state: live
                       http_method: post
-                      usage: workflow_and_inbox
+                      direct_fin_usage: false
+                      created_by_admin_id: '128'
+                      updated_by_admin_id: '128'
                       created_at: '2025-11-15T09:30:00Z'
                       updated_at: '2026-01-20T14:22:15Z'
                       execution_results_url: "/data_connectors/12345/execution_results"
+                    pages:
+                      type: pages
+                      per_page: 20
+                      next:
+                        starting_after: WzE3MDc1OTQ3MTUuMCwxMjM0NV0=
               schema:
                 "$ref": "#/components/schemas/data_connector_list"
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              examples:
+                Invalid cursor:
+                  value:
+                    type: error.list
+                    request_id: test-uuid-replacement
+                    errors:
+                    - code: client_error
+                      message: Invalid starting_after param. Please try again using a starting_after value from a paginated response
+              schema:
+                "$ref": "#/components/schemas/error"
         '401':
           description: Unauthorized
           content:
@@ -21350,14 +21388,18 @@ components:
           - delete
           - patch
           example: post
-        usage:
+        direct_fin_usage:
+          type: boolean
+          description: Whether this data connector is assigned to Fin for direct usage.
+          example: false
+        created_by_admin_id:
           type: string
-          description: Where this data connector can be used.
-          enum:
-          - workflow_and_inbox
-          - fin
-          - fin_voice
-          example: workflow_and_inbox
+          description: The ID of the admin who created this data connector.
+          example: '12345'
+        updated_by_admin_id:
+          type: string
+          description: The ID of the admin who last updated this data connector.
+          example: '12345'
         created_at:
           type: string
           format: date-time
@@ -21530,7 +21572,7 @@ components:
     data_connector_list:
       title: Data Connector List
       type: object
-      description: A list of data connectors.
+      description: A paginated list of data connectors.
       properties:
         type:
           type: string
@@ -21543,6 +21585,28 @@ components:
           description: An array of data connector objects.
           items:
             "$ref": "#/components/schemas/data_connector"
+        pages:
+          type: object
+          description: Pagination information.
+          properties:
+            type:
+              type: string
+              example: pages
+              enum:
+              - pages
+            per_page:
+              type: integer
+              description: The number of results per page.
+              example: 20
+            next:
+              type: object
+              nullable: true
+              description: Cursor for the next page of results.
+              properties:
+                starting_after:
+                  type: string
+                  description: The cursor value to use for the next page.
+                  example: WzE3MDc1OTQ3MTUuMCwxMjM0NV0=
     data_event:
       title: Data Event
       type: object