Skip to content

API Audit Trail

Record every API call and user action for later review.

Overview

The DOMController records the actions performed by users through the API in a dedicated audit store, separate from the operational database. Audit entries are readable through a new API route that supports filtering and pagination, and DOMPloy exposes them in a dedicated panel — visible only to users whose role grants access to it.

The audit trail was introduced alongside granular user roles: once responsibilities are split across several roles, being able to attribute an action to an identity becomes the counterpart to restricting it.

Available since: Version 26.02 (June 2026 · API v34)

How to Use

Prerequisites

  • A user role that grants access to the audit data
  • DOMPloy 6.4.0 or later for the audit panel

Use Cases

  • Security review — reconstruct who changed a configuration and when
  • Support diagnosis — correlate an unexpected device state with the API call that caused it
  • Compliance — answer access-audit questions raised during a site security review

Updates

26.02 — June 2026

Initial Release

  • Every user action performed through the API is recorded in a dedicated audit store
  • New API route to read audit entries, with filters and pagination
  • New audit panel in DOMPloy, restricted to roles allowed to access it