Skip to content

Audit log

Read a website's configuration change history — which resource changed, who changed it, when, and which fields were touched.

Tips & tricks

The audit log answers "who did this" questions directly.

Who changed my search configuration last, and what did they change?

Filter by a resource's id to follow one configuration through time.

Show me the full change history of this Recommendations box.

Keypoints mark the changes that mattered — typically something being set live.

What changed on my website since yesterday? Highlight the keypoints.

auditLog_getEntries

Get a website's configuration change history, newest first. Each entry records which resource changed, who changed it, when, whether it was a create, update or delete, which fields changed, and whether the change was a keypoint. Filter by sourceId for one resource's history, or by sequenceKey for one related series of changes. Billing entries are company-scoped and not available here.

Name Type Required Description
websiteUuid string Yes The website's UUID. Find it in my.helloretail.com under Settings → Website Settings → Website Unique Id.
resourceType array No Only changes to resources of these types, e.g. SEARCH_CONFIG, RECOM_CONFIG, RECOM_DESIGN, PAGES_CONFIG, PAGES_DESIGN, PRODUCT_FEED_CONFIG, NEWSLETTER_CONFIG, TRIGGER_CONFIG, WEBSITE.
sourceId string No Only changes to the resource with this id — one resource's history.
sequenceKey string No Only changes in this related series of entries.
createdAtAfter string No Only changes made at or after this ISO-8601 instant, e.g. 2026-08-25T10:00:00Z.
createdAtBefore string No Only changes made at or before this ISO-8601 instant.
sort string No createdAt_DESC (default) or createdAt_ASC.
limit integer No Maximum number of entries to return. Default 50, max 200.
Example request & response 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "auditLog_getEntries",
    "arguments": {
      "websiteUuid": "<string>",
      "resourceType": ["SEARCH_CONFIG"],
      "createdAtAfter": "2026-08-25T00:00:00Z"
    }
  }
}

{
  "entries": [
    {
      "id": "<string>",
      "createdAt": "2026-08-25T10:00:00Z",
      "resourceType": "SEARCH_CONFIG",
      "resourceTitle": "<string>",
      "auditLogContext": "UPDATE",
      "changedFields": ["state"],
      "keypoint": true,
      "sourceId": "<string>",
      "sequenceKey": "<string>",
      "actor": "<string>"
    }
  ]
}

The actor field names who made the change: a user's name, API Key for changes made through the API, or Hello Retail for changes made by Hello Retail.