Intercom API (unofficial showcase)
PUT/ai/external_pages/{page_id}

Update an external page

Replaces the specified external page's details in your Fin Content Library; this operation applies to pages created through the API. Provide title, html, url, locale, and source_id, and include audience_ids to replace the existing audience memberships.

2 parameters · 8 body fields
page_idstringrequired
The unique identifier of the external page to update.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

External page details. title, html, url, locale, and source_id are required.

titlestringrequired
The title of the external page.
htmlstringrequired
The body of the external page in HTML.
urlstringrequired
The URL of the external page. This will be used by Fin to link end users to the page it based its answer on.
fin_availabilitybooleanoptional
Whether the external page should be used to answer questions by Fin.
Default:true
localestringrequired
Always en
Allowed:enDefault:en
source_idintegerrequired
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_idstringoptional
The identifier for the external page which was given by the source. Must be unique for the source.
audience_idsarray<integer>optional
The list of audience IDs to target this external page to for Fin AI Agent. Replaces all existing audience memberships. Omitting the field leaves existing audience memberships unchanged. Pass `[]` to clear all audience memberships. Unknown audience IDs return a `404` error.

2 status codes
200Returns the updated external page, including its identifier, title, HTML, URL, availability settings, locale, source and audience IDs, and timestamps.
typestringrequired
Always external_page
Allowed:external_pageDefault:external_page
idstringrequired
The unique identifier for the external page which is given by Intercom.
titlestringrequired
The title of the external page.
htmlstringrequired
The body of the external page in HTML.
urlstringoptional
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_availabilitybooleanrequired
Whether the external page should be used to answer questions by AI Agent.
ai_copilot_availabilitybooleanrequired
Whether the external page should be used to answer questions by AI Copilot.
ai_sales_agent_availabilitybooleanoptional
Whether the external page should be used to answer questions by AI Sales Agent.
fin_availabilitybooleanoptional
Deprecated. Use ai_agent_availability and ai_copilot_availability instead.
localestringrequired
Always en
Allowed:enDefault:en
source_idintegerrequired
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_idstringrequired
The identifier for the external page which was given by the source. Must be unique for the source.
audience_idsarray<integer>optional
The list of audience IDs that this external page is targeted to for Fin AI Agent. Empty when the external page has no audience targeting.
created_atintegerrequired
The time when the external page was created.
updated_atintegerrequired
The time when the external page was last updated.
last_ingested_atintegerrequired
The time when the external page was last ingested.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized. title, html, url, locale, and source_id are required, and locale must be en; any audience_ids you provide replace the existing audience memberships.