Skip to main content

Service History

The Core can record a history of API events from all services. This provides a record of system activity across your deployment.

Configuration​

1. Enable the history endpoint in Core​

In your Core configuration, set:

app:
  enableHistoryEndpoint: true

This enables the POST /api/history/v1 endpoint that other services use to push history events.

2. Configure each service to push history​

For each server component, add the following to its configuration:

history:
  type: REMOTE_REST
  enabled: true

Configure this for:

  • Enterprise Backend (one-frontend-backend)
  • Bridge (one-bridge)
  • Wallet-Relying Party Registry (one-wallet-relying-party-registry)
note
  • If using STS authentication: The service authenticates using an STS token with the HISTORY_CREATE permission.
  • If using any other authentication mode: No permission is checked.

User attribution​

If you are using STS authentication, history entries include a user field identifying who triggered the event. In other authentication modes this field is not populated.

Retrieving history​

Once enabled, you can query stored events using:

  • GET /api/history/v1 — list history events (supports filtering)
  • GET /api/history/v1/{id} — retrieve a specific event

For filtering options and query parameters, see Searching and Reading History.