Intercom API (unofficial showcase)
GET/internal_articles/{internal_article_id}

Retrieve an internal article

Retrieves a single internal article by its unique identifier. Use internal_article_id to select the article whose details you need.

2 parameters
internal_article_idintegerrequired
The unique integer identifier of the internal article to retrieve.
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

3 status codes
200Returns the internal article object with its article details.
typestringoptional
The type of object - `internal_article`.
Allowed:internal_articleDefault:internal_article
idstringoptional
The unique identifier for the article which is given by Intercom.
titlestringoptional
The title of the article.
bodystringoptional
The body of the article in HTML.
body_markdownstringoptional
The body of the article in markdown.
owner_idintegeroptional
The id of the owner of the article.
author_idintegeroptional
The id of the author of the article.
created_atintegeroptional
The time when the article was created.
updated_atintegeroptional
The time when the article was last updated.
localestringoptional
The default locale of the article.
folder_idintegeroptional
The ID of the folder this article belongs to, or null if not in a folder.
audience_idsarray<integer>optional
The list of audience IDs this internal article is targeted to for Fin AI Agent. Empty array means no audience targeting is set.
ai_chatbot_availabilitybooleanoptional
Whether the internal article is available for AI Chatbot (Fin).
ai_copilot_availabilitybooleanoptional
Whether the internal article is available for AI Copilot.
ai_sales_agent_availabilitybooleanoptional
Whether the internal article is available for AI Sales Agent.
401Returned when the request is not authorized.

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
404Returned when no internal article exists with the supplied identifier.

One documented failure

  • not_found

    Resource Not Found

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 not authorized. A 404 is returned when no internal article exists with the supplied identifier. The internal_article_id path parameter is the article's unique integer identifier.