Tealium API

Returns the metadata of a published revision. Includes account and profile name, timestamp of the revision, etc.

NOTE: This endpoint needs to be activated for your Tealium iQ account before you can use it. Please contact your Tealium Account Manager.

Resource URL

GET https://api.tealiumiq.com/v1/accounts/[account]/[profile]/revisions/[revisionID]/details

Path Parameters	Description
[account]	Name of the Tealium iQ account.
[profile]	Name of the profile in the account.
[revision ID]	Timestamp of the revision

NOTE: If any of the parameters are empty, you will receive a 404 NOT Found error.

Query Parameter	Description
utk	CSRF security token

Request Header

Header Field Name	Description	Example value
Content-type	Indicates the MIME type of the body of the GET request	application/x-www-form-urlencoded
JSESSION cookie	Cookie for sending jsession ID, i.e. the unique session identifier	JSESSIONID=-415072043799098022

Example Request

GET https://api.tealiumiq.com/v1/accounts/acme/main/revisions/201508181717/details?utk=65489FDSTJGF549870FSH

Example Response

Status 200 OK is returned if the call is successful. Here's a sample response.

{
   "account": "acme",
   "profile": "main",
   "revision_id": "201508181719",
   "name": "UK Google Added",
   "time_created": "Tue 2015.11.03 7:29 GMT",
   "created_by": "user@test.com",
   "comment": "revision notes here",
   "targets_published": ["dev", "qa"],
   "checksums":{
 "dev": {
       "bundle.zip": "###########", //+ SHA-256
       "manifest.json": "###########",
       "utag.js": "###########",
       "utag.1.js": "###########"
},
"qa": {...}
   }
}

NOTE: The "manifest" file inside the bundle contains precisely the same content as the response above. However, it will NOT contain the "checksums" entry for itself and the bundle.

Error Messages

404 Not Found error is returned if the call fails. Here are a few sample error messages:

{ 
   “returnCode” : 1240,
   “message” : “Account was not found” 
}

{ 
   “returnCode” : 1250,
   “message” : “Profile was not found” 
}

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