younifyd
Menu

List Article Versions

List article versions

GET/articles/{article_id}/versions

Use it in a workflow

  1. Add a step and choose the Intercom connector.
  2. Pick the List Article Versions action (under Articles).
  3. Fill in the fields below, then reference the result from later steps as {{listArticleVersions.response.data}}.

Request

Path parameters

article_idintegerrequired

The unique identifier for the article whose versions you are listing.

Query parameters

pageinteger

The page of results to fetch. Defaults to the first page.

per_pageinteger

The number of results to return per page.

localestring

Filter versions to a specific locale. Use the locale identifier (for example `en`, `fr`). If the locale is not configured for the workspace, a `400` is returned.

Headers

Intercom-Versionstring

Intercom API version.</br>By default, it's equal to the version set in the app package.

One of1.01.11.21.31.42.02.12.22.32.42.52.62.72.82.92.102.112.122.132.142.152.16Default "2.16"

Response

Returns 200 with an object. Read it in later steps with {{listArticleVersions.response.data.<field>}}.

typestring

The type of the object - `list`.

One oflist

pagesobject

Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.

typestring

the type of object `pages`.

One ofpages

pageinteger

The current page

nextobject2 fields
per_pageinteger

Number of results per page

total_pagesinteger

Total number of pages

total_countinteger

A count of the total number of versions.

dataarray<object>

An array of Article version summary objects.

typestring

String representing the object's type. Always has the value `article_version`.

One ofarticle_version

idstring

The unique identifier for the version.

article_idstring

The unique identifier of the article this version belongs to.

titlestring

The title of the article at this version.

descriptionstring

The description of the article at this version.

author_idstring

The id of the teammate listed as the article's author at this version.

created_by_idstring

The id of the teammate who created this version.

created_viastring

How this version was created (for example `web`, `api`).

from_version_idstring

The id of the version this version was created from, or `null` if this is the first version.

statestring

Whether this version is the currently published version of the article (`published`) or an earlier non-live version (`draft`).

One ofpublisheddraft

created_atinteger (date-time)

The time the version was created, as a UTC Unix timestamp.

json
{
  "type": "list",
  "pages": {
    "type": "pages",
    "page": 1,
    "next": {
      "per_page": 2,
      "starting_after": "your-cursor-from-response"
    },
    "per_page": 2,
    "total_pages": 13
  },
  "total_count": 2,
  "data": [
    {
      "type": "article_version",
      "id": "301",
      "article_id": "123",
      "title": "This is the article title",
      "description": "",
      "author_id": "991267502",
      "created_by_id": "5017691",
      "created_via": "web",
      "from_version_id": "300",
      "state": "published",
      "created_at": 1734537292
    }
  ]
}

Need more? See the Intercom guide for connection setup and behaviour shared by every action.