Audit Trails

Audit trails play a critical role in ensuring transparency, compliance, and trust within the DOVU OS system.

Audit trails play a critical role in ensuring transparency, compliance, and trust within the DOVU OS system. By providing a detailed record of every action and event associated with a workflow instance, these trails form the backbone of provenance tracking. Whether for visualizing credits in a marketplace or generating compliance reports, audit trails offer the insights needed to validate the integrity of credits.

Key Benefits

1. End-to-End Provenance: Track the entire lifecycle of a credit, from its creation to issuance, transfer, and beyond. This ensures that every step in the workflow is fully traceable.

2. Marketplace Visualization: Enable third-party marketplaces or platforms to display the complete journey of a credit, giving buyers and stakeholders confidence in its authenticity and impact.

3. Compliance and Reporting: Provide detailed records to meet regulatory requirements or demonstrate adherence to industry standards. This is especially valuable for sustainability-focused projects.

4. Seamless Integration: Use the audit trail data to integrate with front-end visualizations, dashboards, or external systems, enabling easy consumption of the provenance data.

---

How It Works

• The Get Workflow Instance Audit Trail endpoint retrieves a chronological list of actions, events, and associated metadata for a specific workflow instance.

• Each audit trail entry captures key information such as timestamps, user actions, workflow transitions, and schema updates.

• The endpoint supports structured responses, including pagination and links for navigating large datasets.

---

Get Workflow Instance Audit Trail

GET/api/v1/workflow-instances/workflow_instance_id/audit-trail

Header parameters

Response

200404

Body

application/json

data*array of string

links*object

meta*object

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/workflow-instances/workflow_instance_id/audit-trail', {
    method: 'GET',
    headers: {
      "Accept": "text"
    },
});
const data = await response.json();

Response

200404

{
  "data": [
    "text"
  ],
  "links": {
    "first": "text",
    "last": "text"
  },
  "meta": {
    "current_page": 0,
    "last_page": 0,
    "links": [
      {
        "url": "text",
        "label": "text",
        "active": false
      }
    ],
    "path": "text",
    "per_page": 0,
    "total": 0
  }
}