Skip to content

Commit 0c5f97b

Browse files
ellicenelsonclaude
andcommitted
docs: Add cursor pagination to Data Connectors list endpoint
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 35a19b9 commit 0c5f97b

1 file changed

Lines changed: 59 additions & 1 deletion

File tree

descriptions/0/api.intercom.io.yaml

Lines changed: 59 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10046,6 +10046,21 @@ paths:
1004610046
in: header
1004710047
schema:
1004810048
"$ref": "#/components/schemas/intercom_version"
10049+
- name: per_page
10050+
in: query
10051+
required: false
10052+
description: The number of results to return per page. Defaults to 20, minimum 1, maximum 50.
10053+
schema:
10054+
type: integer
10055+
default: 20
10056+
minimum: 1
10057+
maximum: 50
10058+
- name: starting_after
10059+
in: query
10060+
required: false
10061+
description: The cursor value from `pages.next.starting_after` in a previous response. Used to paginate through results.
10062+
schema:
10063+
type: string
1004910064
tags:
1005010065
- Data Connectors
1005110066
operationId: listDataConnectors
@@ -10054,6 +10069,8 @@ paths:
1005410069

1005510070
Data connectors allow you to make HTTP requests to external APIs from Intercom workflows and AI agents.
1005610071
Each connector in the response includes an `execution_results_url` for navigating to its execution logs.
10072+
10073+
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.
1005710074
responses:
1005810075
'200':
1005910076
description: successful
@@ -10074,8 +10091,27 @@ paths:
1007410091
created_at: '2025-11-15T09:30:00Z'
1007510092
updated_at: '2026-01-20T14:22:15Z'
1007610093
execution_results_url: "/data_connectors/12345/execution_results"
10094+
pages:
10095+
type: pages
10096+
per_page: 20
10097+
next:
10098+
starting_after: WzE3MDc1OTQ3MTUuMCwxMjM0NV0=
1007710099
schema:
1007810100
"$ref": "#/components/schemas/data_connector_list"
10101+
'400':
10102+
description: Bad Request
10103+
content:
10104+
application/json:
10105+
examples:
10106+
Invalid cursor:
10107+
value:
10108+
type: error.list
10109+
request_id: test-uuid-replacement
10110+
errors:
10111+
- code: client_error
10112+
message: Invalid starting_after param. Please try again using a starting_after value from a paginated response
10113+
schema:
10114+
"$ref": "#/components/schemas/error"
1007910115
'401':
1008010116
description: Unauthorized
1008110117
content:
@@ -21530,7 +21566,7 @@ components:
2153021566
data_connector_list:
2153121567
title: Data Connector List
2153221568
type: object
21533-
description: A list of data connectors.
21569+
description: A paginated list of data connectors.
2153421570
properties:
2153521571
type:
2153621572
type: string
@@ -21543,6 +21579,28 @@ components:
2154321579
description: An array of data connector objects.
2154421580
items:
2154521581
"$ref": "#/components/schemas/data_connector"
21582+
pages:
21583+
type: object
21584+
description: Pagination information.
21585+
properties:
21586+
type:
21587+
type: string
21588+
example: pages
21589+
enum:
21590+
- pages
21591+
per_page:
21592+
type: integer
21593+
description: The number of results per page.
21594+
example: 20
21595+
next:
21596+
type: object
21597+
nullable: true
21598+
description: Cursor for the next page of results.
21599+
properties:
21600+
starting_after:
21601+
type: string
21602+
description: The cursor value to use for the next page.
21603+
example: WzE3MDc1OTQ3MTUuMCwxMjM0NV0=
2154621604
data_event:
2154721605
title: Data Event
2154821606
type: object

0 commit comments

Comments
 (0)