List versions of a data connector

Request

Retrieve the version history of a data connector, newest first. Each entry is a point-in-time snapshot of the connector's configuration, with the status it has today and an optional note.

Results are paginated. pages.next is omitted on the last page. A data connector that has never been published returns an empty data list.

Requires the read_data_connector_versions or read_write_data_connector_versions OAuth scope.

Security

bearerAuth

Path

idstringrequired

The unique identifier for the data connector.

Example:12345

Query

per_pageinteger, [ 1 .. 50 ]

The number of results per page (1-50, default 20). Values outside this range are clamped, so values below 1 are treated as 1. A non-integer value falls back to the default of 20.

Default:20

starting_afterstring

Cursor for pagination. Use the value from pages.next.starting_after in a previous response.

Intercom-Versionstring(intercom_version)

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

Default:"2.17"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.17

curl -i -X GET \
  'https://api.intercom.io/data_connectors/12345/versions?per_page=20&starting_after=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.17'

Responses

successful

Bodyapplication/json

typestring

The type of object - list.

Value:"list"

Example:"list"

dataArray of objects(Data Connector Version)

An array of data connector version objects.

pagesobject

Pagination information. next is omitted on the last page.

Response

{
  "type": "list",
  "data": [
    { … },
    { … }
  ],
  "pages": {
    "type": "pages",
    "per_page": 20,
    "next": { … }
  }
}