Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.meshai.dev/llms.txt

Use this file to discover all available pages before exploring further.

MeshAI records an immutable audit event for every governance action. Audit events cannot be modified or deleted once created. This satisfies EU AI Act Article 12 (record-keeping) requirements.

​
Event Types

Event TypeDescription
agent.registeredA new agent was registered
agent.updatedAgent metadata was changed
agent.deletedAn agent was removed
agent.classifiedRisk classification was assigned or changed
policy.createdA new policy was created
policy.updatedA policy was modified
policy.deletedA policy was removed
policy.violatedA request violated a policy
approval.requestedA HITL approval was queued
approval.decidedAn approval was approved or denied
anomaly.detectedAn anomaly was detected
anomaly.acknowledgedAn anomaly was acknowledged
anomaly.resolvedAn anomaly was resolved
incident.createdA serious incident was reported
incident.updatedAn incident was updated
fria.createdA FRIA was submitted
fria.updatedA FRIA was modified

​
List Audit Events

curl "https://api.meshai.dev/governance/audit-trail?limit=50" \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": "evt_abc123",
      "event_type": "agent.registered",
      "actor": "user@company.com",
      "target_id": "agt_xyz789",
      "target_type": "agent",
      "details": {
        "agent_name": "production-summarizer",
        "framework": "crewai"
      },
      "timestamp": "2026-03-17T10:00:00Z"
    },
    {
      "id": "evt_def456",
      "event_type": "anomaly.acknowledged",
      "actor": "admin@company.com",
      "target_id": "ano_ghi789",
      "target_type": "anomaly",
      "details": {
        "anomaly_type": "cost_spike",
        "note": "Expected spike due to batch processing"
      },
      "timestamp": "2026-03-17T09:45:00Z"
    }
  ],
  "meta": { "total": 234, "page": 1, "limit": 50 }
}

​
Filtering

Filter audit events by type, actor, target, and time range: 
# By event type
curl "https://api.meshai.dev/governance/audit-trail?event_type=policy.violated" \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

# By agent
curl "https://api.meshai.dev/governance/audit-trail?target_id=agt_abc123" \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

# By date range
curl "https://api.meshai.dev/governance/audit-trail?from=2026-03-01T00:00:00Z&to=2026-03-17T23:59:59Z" \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

# Combined filters
curl "https://api.meshai.dev/governance/audit-trail?event_type=anomaly.detected&from=2026-03-01T00:00:00Z&limit=100" \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

​
Export

Export audit events in CSV or JSON format for compliance reporting and external audit tools: 
curl "https://api.meshai.dev/governance/audit-trail/export?format=csv&from=2026-01-01T00:00:00Z" \
  -H "Authorization: Bearer msh_YOUR_API_KEY" \
  -o audit-trail.csv

​
Retention

Audit events are retained for the duration of your subscription:
PlanRetention
Starter90 days
Professional1 year
Enterprise3 years
Enterprise PlusUnlimited