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.

EU AI Act Article 73 requires providers and deployers to report serious incidents involving high-risk AI systems to the relevant market surveillance authority. MeshAI provides structured incident creation, deadline tracking, and authority notification support.

​
What Is a Serious Incident?

Article 3(49) defines a serious incident as an event that directly or indirectly leads to or could have led to:
  • Death or serious damage to health
  • Serious and irreversible disruption of critical infrastructure management
  • Breach of fundamental rights obligations

​
Reporting Deadlines

DeadlineConditionTimeframe
2 daysDeath or serious damage to healthWithin 2 days of awareness
15 daysAll other serious incidentsWithin 15 days of awareness
MeshAI automatically calculates the deadline based on incident severity and tracks it in the dashboard.

​
Create an Incident

curl -X POST https://api.meshai.dev/incidents \
  -H "Authorization: Bearer msh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_abc123",
    "title": "Discriminatory output in hiring agent",
    "severity": "serious",
    "description": "The HR screening agent systematically ranked female candidates lower than male candidates with equivalent qualifications over a 2-week period.",
    "impact": "Approximately 120 job applicants may have been affected by biased rankings.",
    "immediate_actions": "Agent suspended immediately. Manual re-review of all affected applications initiated.",
    "root_cause": "Training data contained historical hiring bias that was not sufficiently mitigated.",
    "affected_persons_count": 120,
    "involves_health_or_death": false
  }'

{
  "success": true,
  "data": {
    "id": "inc_abc123",
    "agent_id": "agt_abc123",
    "title": "Discriminatory output in hiring agent",
    "severity": "serious",
    "status": "open",
    "deadline": "2026-04-01T10:00:00Z",
    "deadline_days": 15,
    "involves_health_or_death": false,
    "affected_persons_count": 120,
    "created_at": "2026-03-17T10:00:00Z",
    "authority_notified": false
  }
}

​
Incident Statuses

StatusDescription
openIncident created, under investigation
investigatingRoot cause analysis in progress
mitigatedImmediate corrective actions taken
reportedAuthority has been notified
closedInvestigation complete, incident resolved

​
Track an Incident

curl https://api.meshai.dev/incidents/inc_abc123 \
  -H "Authorization: Bearer msh_YOUR_API_KEY"

​
Update an Incident

curl -X PATCH https://api.meshai.dev/incidents/inc_abc123 \
  -H "Authorization: Bearer msh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "mitigated",
    "update_note": "All 120 affected applications have been manually re-reviewed. 8 candidates were re-ranked and contacted."
  }'

​
Notify Authority

When you’re ready to report to the market surveillance authority: 
curl -X POST https://api.meshai.dev/incidents/inc_abc123/notify-authority \
  -H "Authorization: Bearer msh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "authority": "National AI Authority",
    "contact_email": "incidents@authority.gov",
    "additional_notes": "Full investigation report attached."
  }'
This action:
  • Sets the incident status to reported
  • Records the notification in the audit trail
  • Stores the authority contact details for follow-up

​
Dashboard Alerts

The MeshAI dashboard shows:
  • Active incidents with countdown timers to reporting deadlines
  • Overdue incidents highlighted in red
  • Deadline approaching warnings 48 hours before the deadline