---
title: "List external pages"
method: GET
path: "/ai/external_pages"
tags: ["AI Content"]
---

# List external pages

`GET /ai/external_pages`

You can retrieve a list of all external pages for a workspace.

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

successful

- ExternalPagesList — This will return a list of external pages for the App.
  - `type` 'list' — The type of the object - `list`.
  - `pages` PagesLink — The majority of list resources in the API are paginated to allow clients to traverse data over multiple requests. Their responses are likely to contain a pages object that hosts pagination links which a client can use to paginate through the data without having to construct a query. The link relations for the pages field are as follows.
    - `type` 'pages'
    - `page` integer
    - `next` string, uri, nullable — A link to the next page of results. A response that does not contain a next link does not have further data to fetch.
    - `per_page` integer
    - `total_pages` integer
  - `total_count` integer — A count of the total number of external pages.
  - `data` ExternalPage[] — An array of External Page objects
    - `type` 'external_page', required — Always external_page
    - `id` string, required — The unique identifier for the external page which is given by Intercom.
    - `title` string, required — The title of the external page.
    - `html` string, required — The body of the external page in HTML.
    - `url` string — The URL of the external page. This will be used by Fin to link end users to the page it based its answer on.
    - `ai_agent_availability` boolean, required — Whether the external page should be used to answer questions by AI Agent.
    - `ai_copilot_availability` boolean, required — Whether the external page should be used to answer questions by AI Copilot.
    - `ai_sales_agent_availability` boolean — Whether the external page should be used to answer questions by AI Sales Agent.
    - `fin_availability` boolean — Deprecated. Use ai_agent_availability and ai_copilot_availability instead.
    - `locale` 'en', required — Always en
    - `source_id` integer, required — The unique identifier for the source of the external page which was given by Intercom. Every external page must be associated with a Content Import Source which represents the place it comes from and from which it inherits a default audience (configured in the UI). For a new source, make a POST request to the Content Import Source endpoint and an ID for the source will be returned in the response.
    - `external_id` string, required — The identifier for the external page which was given by the source. Must be unique for the source.
    - `created_at` integer, required — The time when the external page was created.
    - `updated_at` integer, required — The time when the external page was last updated.
    - `last_ingested_at` integer, required — The time when the external page was last ingested.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)