18 November 2026
API
Enhancement
Deprecation
Audit Log
The Change History API now preserves and exposes agent attribution. When an internal agent, such as the Promotions Agent or the Managed Commerce MCP, makes a change on behalf of a user, that attribution is now recorded and visible, instead of appearing with an empty modifier.
The ModifiedBy object is aligned with the LastModifiedBy object of the HTTP API.

Changes:

  • Added the externalUserId and attributedTo fields to the ModifiedBy object. The attributedTo field uses the new Attribution type and is only set for changes made after 22 October 2026.
  • In GraphQL, added the customerRef and associateRef fields to the lastModifiedBy type, to align with the GraphQL API.
  • Added the following values to the source (REST) and sources (GraphQL) filters, corresponding to AttributionSource values: Import, Export, ManagedCommerceMCP, PromotionsAgent, ProductEnrichmentAgent, and IntakeAgent.
  • Filtering by source: ApiClient returns changes made through Import, Export, or the Managed Commerce MCP when using Client IDs.
  • For Audit Log Basic (Basic Tier) Projects, agent and MCP-based changes are not recorded, consistent with existing tier limitations.

Deprecations:

The following will be deprecated on 16 February 2027:

  • The id and type fields of the ModifiedBy object.
  • The ImpEx source filter value. For changes made on or after 22 October 2026, it matches only changes with direct Import or Export attribution. Use Import or Export instead.
  • In GraphQL, the customer and associate fields of the lastModifiedBy type. Use customerRef and associateRef instead.