Article

The data returned about your articles when you list them.

object or null (Article Statistics)

The statistics of an article.

type
string
Default: "article"

The type of object - article.

Value: "article"
id
string

The unique identifier for the article which is given by Intercom.

workspace_id
string

The id of the workspace which the article belongs to.

title
string

The title of the article. For multilingual articles, this will be the title of the default language's content.

description
string or null

The description of the article. For multilingual articles, this will be the description of the default language's content.

body
string or null

The body of the article in HTML. For multilingual articles, this will be the body of the default language's content.

author_id
integer

The id of the author of the article. For multilingual articles, this will be the id of the author of the default language's content. Must be a teammate on the help center's workspace.

state
string
Default: "draft"

Whether the article is published or is a draft. For multilingual articles, this will be the state of the default language's content.

Enum: "published" "draft"
created_at
integer <date-time>

The time when the article was created. For multilingual articles, this will be the timestamp of creation of the default language's content in seconds.

updated_at
integer <date-time>

The time when the article was last updated. For multilingual articles, this will be the timestamp of last update of the default language's content in seconds.

url
string or null

The URL of the article. For multilingual articles, this will be the URL of the default language's content.

parent_id
integer or null

The id of the article's parent collection or section. An article without this field stands alone.

parent_ids
Array of integers

The ids of the article's parent collections or sections. An article without this field stands alone.

parent_type
string or null

The type of parent, which can either be a collection or section.

default_locale
string

The default locale of the help center. This field is only returned for multilingual help centers.

object or null (Article Translated Content)

The Translated Content of an Article. The keys are the locale codes and the values are the translated content of the article.

{ "statistics": { "type": "article_statistics", "views": 10, "conversions": 0, "reactions": 10, "happy_reaction_percentage": 40, "neutral_reaction_percentage": 40, "sad_reaction_percentage": 20 }, "type": "article", "id": "6871119", "workspace_id": "hfi1bx4l", "title": "Default language title", "description": "Default language description", "body": "Default language body in html", "author_id": "5017691", "state": "published", "created_at": 1672928359, "updated_at": 1672928610, "url": "http://intercom.test/help/en/articles/3-default-language", "parent_id": "125685", "parent_ids": [ 18, 19 ], "parent_type": "collection", "default_locale": "en", "translated_content": { "type": "article_translated_content", } }