Audit Trails

​

Audit Trail Overview

OK!Gotcha provides detailed audit trails for all approval-related activities. Every action in the approval workflow is logged with relevant metadata, creating a complete audit trail that can be used for compliance, debugging, and analytics.

​

What Gets Logged

​

Accessing Audit Logs

​

Dashboard Access

Audit logs are available in the OK!Gotcha dashboard, with filtering and search capabilities to help you find specific events:

https://app.okgotcha.com/audit-logs

​

API Access

You can also access audit logs programmatically via the API:

import { OkGotcha } from '@okgotcha/sdk';

const ok = OkGotcha();

// Get audit logs for a specific time range
const logs = await ok.getAuditLogs({
  startTime: new Date('2023-01-01'),
  endTime: new Date('2023-01-31'),
  limit: 100,
  offset: 0
});

// Get audit logs for a specific approval
const approvalLogs = await ok.getAuditLogs({
  approvalId: 'apr_12345'
});

​

Log Structure

Each audit log entry includes:

​

Retention and Compliance

Audit logs are retained for a configurable period based on your plan:

For regulated industries, we offer extended retention options and compliance certifications:

​

Export Options

Audit logs can be exported in several formats:

# Export logs to JSON via the API
curl -X GET "https://api.okgotcha.com/v1/audit-logs?startTime=2023-01-01&endTime=2023-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  > audit_logs.json

​

Next Steps

• Learn about notification options for approval events
• Set up flexible workflows for different approval scenarios
• Explore integration options for implementing approvals