Reports

What you'll learn: How to generate compliance audit reports from the Kyvvu platform.

---

Audit reports

The platform generates audit reports that summarize agent activity, policy compliance, and incident history. Reports are available in PDF and XML formats.

Generating a report

Via the dashboard

1. Navigate to Reports in the sidebar.

2. Select the report parameters:

   • Format — PDF or XML.

   • Time range — start and end dates.

   • Agent (optional) — scope to a specific agent.

3. Click Generate.

4. Download the report when ready.

Via the API

curl "https://platform.kyvvu.com/api/v1/reports/audit?format=pdf&start_date=2026-04-01&end_date=2026-04-30" \
  -H "Authorization: Bearer <JWT>" \
  -o audit-report.pdf

Query parameters:

Parameter	Type	Required	Description
format	pdf or xml	Yes	Output format.
start_date	ISO date	No	Start of reporting period.
end_date	ISO date	No	End of reporting period.
agent_id	string	No	Scope to a specific agent.

Report contents

Reports include:

• Agent summary — registered agents, their classifications, and environments.

• Policy summary — active policies, their scopes and severities.

• Incident summary — violations grouped by severity, status, and agent.

• Activity summary — log volume, step type distribution, task counts.

• Hash chain validation — integrity status of the behavioral trace.

XML reports use a structured schema suitable for automated compliance tooling and regulatory submission.

---

Next steps

• Incident Management — the incident data that feeds reports

• Dashboard Guide — navigate the platform

• Organizations & Access — access control for reports