iQ Revisions API endpoints

This is an older version of the current Tealium iQ Revisions API.

List revisions

Returns an array of revision IDs. The revision ID is the timestamp of the revision in the form of “YYYYMMDDHHMM”. This ID is used to fetch the revision details.

GET /v1/accounts/{account}/{profile}/revisions

cURL Request

curl -b JSESSIONID={session_id} \
  https://api.tealiumiq.com/v1/accounts/{account}/{profile}/revisions?utk={token}

Example response

["201508181719",
 "201508181718",
 "201508181717"]

The revision IDs are listed in reverse chronological order with the newest revision first.

Error messages

400 NOT FOUND

{
   "returnCode" : 1240,
   "message" : "Account was not found"
}

{
   "returnCode" : 1250,
   "message" : "Profile was not found"
}

Get revision details

Returns the revision details.

GET /v1/accounts/{account}/{profile}/revisions/{revision_id}/details

cURL Request

curl -i -b JSESSIONID={session_id} \
  https://api.tealiumiq.com/v1/accounts/{account}/{profile}/revisions/{revision_id}/details?utk={token}

Example Response

{
    "account": "tealium",
    "profile": "profile",
    "name": "Full Release - 2016/12/13 19:53",
    "time_created": "Tue 2016.12.13 19:54 GMT",
    "checksums": {
        "prod": {
            "manifest.json": "df8bb8bdb8bc34f9d70d98ff49fdcf53e7f286520747001538b74357418178a2",
            "bundle.zip": "9309364527db38cd33538ca239929c3ed89b7b6990e99b4a41d16b50dd519e35",
            "utag.js": "3c34236708b14e8fd8a82e5c363d006793fd59fc6f6a6f0367634cf245d16861",
            "utag.1.js": "9b911570ac0685a50a3a32ef780a2570b16725779b7336bdbfca2838eea6d216",
            "utag.2.js": "0d3cbf8b3d275d181c2140c2eab88ead3c9f2002b5260d9ebd9f23cb7b60de9a"
        }
    },
    "revision_id": "201612131954",
    "comment": "up to date publish",
    "created_by": "user@example.com",
    "targets_published": ["prod"]
}

Error Messages

404 Not Found

{
   "returnCode" : 1240,
   "message" : "Account was not found"
}

{
   "returnCode" : 1250,
   "message" : "Profile was not found"
}

{
   "returnCode" : 1260,
  "message" : "Revision details do not exist"
}

Get revision bundle

A revision bundle is the deployable corpus of the published JavaScript files for the target environment in the form of a zip file. If a revision was published, the value from “targets_published” will be used in this endpoint to retrieve the desired files. For example: “prod”.

GET /v1/accounts/{account}/{profile}/revisions/{revision_id}/{target}

cURL Request

curl -b JSESSION={session_id} \
  http://api.tealiumiq.com/v1/accounts/{account}/{profile}/revisions/{revision_id}/{target}?utk={token} \
  -o utag.zip

Response

The request returns a “.zip” file that contains:

• utag.js- the main loader file
• utag.*.js- the vendor tag files. For example: utag.13.js.
• utag.sync.js- (Optional) the synchronous loader file
• mobile.html- (Optional) mobile library configuration
• manifest.json- this JSON file contains the same information returned by the Revision Details endpoint minus the SHA256 of the bundle.

Error Messages

400 NOT FOUND

{
   "returnCode" : 1270,
   "message" : "The revision bundle requested is not the latest"
}