Get an account's audit trail records.
Request
Method | URL |
---|---|
POST | https://{domain}/api/account/{accountId}/configuration/metadata/audit |
Request Headers
Header | Description |
---|---|
Authorization | Contains token string to allow request authentication and authorization. See the introduction page for more details. |
Content-Type | application/json |
Accept | application/json |
Path Parameters
Parameter | Description | Type | Notes |
---|---|---|---|
accountId | LP site ID | string | Validation fail error code: 400 |
Query Parameters
N/A
Request Body
Contains a JSON object with a single "query" field which defines the requested GraphQL query for the auditData API and the fields sub-select. For details see graphql website.
{"query" :
"{auditData {
accountId
objectType
objectName
element
oldValue
newValue
originator
originatorLoginName
originatorUserId
originatorUserAgent
originatorAuthType
originatorIsLpa
changeDate}}"
}
Required parameters At least one parameter from the above parameters is required in order to retirve audit data.
Optional graphql parameters
name | Description | Notes |
---|---|---|
fromDate | Start date for filtering | Format: yyyy-MM-dd |
toDate | End date for filtering | Format: yyyy-MM-dd |
first | Number of records to return | Default: 50 |
offset | Offset to start returning records from | |
orderBy | List of columns to order by | Default: changeTimestamp |
orderDirection | List of ordering direction (ASC, DESC), in relevance to orderBy list | Default: DESC |
users | List of users for filtering | |
componentTypes | List of component types for filtering | |
language | Language to return the results in | Default: en-US |
timezone | Time zone to use in results | Default: US/Eastern |
lpa | Boolean, include changes done by LPAs in the results | Default: false |
automaticUpdates | Boolean, include automatic updates in the results | Default: false |
Example:
{"query" :
"{auditData (lpa:true) { accountId objectType element oldValue newValue originatorIsLpa changeDate}}"
}
Response
Response type
JSON
Response Headers
Header | Description |
---|---|
X-Total-Count | Contains the count of returned audit items |
Response Codes
Code | Description |
---|---|
200 | OK |
400 | Bad Request |
401 | Not Authenticated |
403 | Not Authorized |
500 | Internal Server Error |
Response Body
{
"data": {
"auditData": [
{
"accountId": "le52642741",
"objectType": "Profiles",
"element": "Generate secure form token",
"oldValue": "false",
"newValue": "true",
"originatorIsLpa": false,
"changeDate": "2019-11-12 06:10:46.0"
},
{
"accountId": "le52642741",
"objectType": "Campaigns",
"element": "N/A",
"oldValue": "",
"newValue": "",
"originatorIsLpa": false,
"changeDate": "2019-10-31 10:35:37.0"
},
{
"accountId": "le52642741",
"objectType": "Users",
"element": "N/A",
"oldValue": "",
"newValue": "",
"originatorIsLpa": false,
"changeDate": "2019-10-30 08:56:59.0"
},
{
"accountId": "le52642741",
"objectType": "Predefined Content",
"element": "N/A",
"oldValue": "",
"newValue": "",
"originatorIsLpa": false,
"changeDate": "2019-10-30 08:56:55.0"
},
{
"accountId": "le52642741",
"objectType": "Content Categories",
"element": "N/A",
"oldValue": "",
"newValue": "",
"originatorIsLpa": false,
"changeDate": "2019-10-30 08:56:55.0"
},
{
"accountId": "le52642741",
"objectType": "Agent Groups",
"element": "N/A",
"oldValue": "",
"newValue": "",
"originatorIsLpa": false,
"changeDate": "2019-10-30 08:56:54.0"
}
]
}
}