From 279fb00d2d8c5e13a26788b1bc81fd455be1a55f Mon Sep 17 00:00:00 2001
From: Ivan Branimir Skoric <58559012+ib-skoric@users.noreply.github.com>
Date: Mon, 2 Nov 2026 10:50:55 +0000
Subject: [PATCH] Document the external_id filter on the external pages list in
 Preview

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index fc223902..715b246a 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -2330,12 +2330,26 @@ paths:
           default: 50
         description: The number of results to return per page. Maximum 150.
         example: 50
+      - name: source_id
+        in: query
+        schema:
+          type: integer
+        description: The unique identifier for the source of the external page which was given by Intercom. Must be sent with `external_id`.
+        example: 42
+      - name: external_id
+        in: query
+        schema:
+          type: string
+        description: The identifier for the external page which was given by the source. Must be sent with `source_id`.
+        example: '3'
       tags:
       - AI Content
       operationId: listExternalPages
       description: |
         You can retrieve a list of all external pages for a workspace.
 
+        Send `source_id` and `external_id` together to get only the external page with that external ID. If no external page matches, the list is empty.
+
         OAuth tokens must have the `read_write_ai_content` scope.
       responses:
         '200':
@@ -2459,6 +2473,13 @@ paths:
                     errors:
                     - code: bad_request
                       message: page limit reached, please use scroll API
+                Missing source_id or external_id:
+                  value:
+                    type: error.list
+                    request_id: 3f8e1c92-7a4d-4b6e-9c05-1d2e3f4a5b6c
+                    errors:
+                    - code: parameter_invalid
+                      message: source_id and external_id must be provided together
               schema:
                 "$ref": "#/components/schemas/error"
     post: