Entity History displays the historical updates made to entities. It can be accessed via Knowledge Graph > Configuration > Entity History, or from the Entity Edit view for a single entity, or via the Logs API.

Entity History UI

The Entity History page displays a table of past entity updates. By default, history is displayed by operation. Toggle to view by individual events.

View by Operation

Click an operation to view operation details, which include hero metrics (entities updated, created, deleted), expanded actor details, fields updated, a table of individual events, and options to undo or reapply the operation.

View by Event

Click an event to view event details in a side panel: entity, event type, actor, language, operation ID, and the previous and updated field values for "Field Updated" events (viewable in UI format or JSON).

Undo and Reapply Field Updates

From the Entity History UI, you can undo or reapply operations and events to restore field values on entities. This applies only to Field Updated event types and is only available in the UI.

Undoing an operation or event restores the affected field values to whatever they were before the operation or event took place.

Reapplying an operation or event re-adds the affected field values as they were in the original operation or event.

Both actions only apply to the entities and fields that were edited by the original operation or event. Any entities or fields not part of the original operation or event will not be changed.

Note: This is best used when you want to undo changes to specific fields on certain entities. To restore all fields on an entity profile to a previous point in time, use the Restore Entity Data from a Previous Date approach instead.

Steps

1. Navigate to Knowledge Graph > Configuration > Entity History. Toggle to Group by Operation or All Events, depending on whether you want to undo an entire operation or a single event.
2. Locate the operation or event you want to undo using the filter options at the top of the table:
   • Date: filter by when the change took place
   • Entity: filter by entity name (Event view only)
   • Entity Type: filter by entity type (Event view only)
3. If you are undoing or reapplying an entire operation, click on the desired operation. From the Operation Details page, click either Undo this Operation to undo the changes made in the operation, or click Reapply these Updates to reapply the changes that were made in the original operation.

4. To undo or reapply a single event: find the event in the Entity History table, click the three-dot icon on the right side of the row, and select Undo this Change or Reapply this Value.

   Note: Operations can also be selected via the three-dot icon on the Operations view of the Entity History table.

Not Supported

Undo and reapply are not supported for:

• Any event type other than Field Updated (note: FIELD_UPDATED_INHERITED is not supported)
• Multiple changes on the same field for the same entity
• Newly created entities whose ID shows "Value Pending"
• The following fields: Country Code, Coordinates (Display, Dropoff, Pickup, Routable, Walkable), Locale, any image fields

Entity History via API

Entity History can be accessed by querying the entityHistory table via the POST query endpoint of the Logs API. You will need a Developer App with Logs endpoint permissions set to read-only. See the Create an App in the Developer Console guide to get started.

For sample requests and responses, see the Logs API documentation.

Events

Actors

An actor is the source responsible for an event in an entity's history. Actor details provide further information about the exact source.

For example, an event could have been caused by a User (the actor) via Entity Edit (the actor details).

Most Yext System updates appear as a separate action triggered by a Yext User event. For example, updating an Address field triggers two rows in Entity History: one for the Yext User edit, and one for the Yext System geocoding that follows.

Actor Types: App, Yext System, Yext User, Yext Account Team, Connector.

Actor Details

Legacy Actor Details

These actor details may appear in older history but will not appear on new events going forward.

Limitations

Global

• Entity History is limited to the last three years (1,095 days). Events older than three years are deleted.
• Newly created entities appear with an undefined entity type and an ID of "Value Pending." It may take up to one hour for these values to sync. Field values cannot be restored until they resolve.
• It may take up to five minutes for new update logs to appear.

UI

• Exporting logs is not currently supported.
• FIELD_UPDATED_INHERITED events cannot be restored.
• Field values cannot be restored on: Country Code, Coordinates (Display, Dropoff, Pickup, Routable, Walkable), Locale, or any image fields.

API

• Field updates cannot be undone or reapplied.