KAKUNIN

API Reference

Complete endpoint reference for the Kakunin v1 API. All methods, parameters, response shapes, error codes, rate limits, and authentication patterns for building integrations.

Base URL

https://api.kakunin.ai/v1

All requests must include Authorization: Bearer <api_key>.

Agents

MethodPathDescription
POST/agentsRegister a new agent
GET/agentsList all agents
GET/agents/{id}Get agent details
POST/agents/{id}/certifyIssue X.509 certificate

Certificates

MethodPathDescription
GET/certificatesList certificates
GET/certificates/{id}Get certificate
POST/certificates/{id}/revokeRevoke certificate

Events

MethodPathDescription
POST/eventsIngest a behaviour event
GET/eventsQuery events (cursor-paginated)

Reports

MethodPathDescription
POST/reports/complianceRequest a compliance report
GET/reports/{id}Get report status and summary
GET/reports/{id}/pdfDownload PDF report

Audit Log

MethodPathDescription
GET/audit-logQuery immutable audit trail (cursor-paginated)

Health

MethodPathDescription
GET/healthCheck API and DB connectivity

Response Shapes

Success:

{ "data": { ... } }

Error:

{ "error": "Human-readable error message" }

HTTP Status Codes

CodeMeaning
200Success
201Created
202Accepted (async job queued)
400Invalid input
401Authentication required
404Resource not found
409Conflict (e.g., duplicate active certificate)
422Unprocessable (e.g., certify a retired agent)
425Too Early (report still generating)
429Rate limit exceeded
500Internal server error
503Dependency unavailable (e.g., KMS)

EU AI Act Agent Compliance & Audit Readiness Checklist

A C-suite and engineering guide to achieving EU AI Act agent compliance, MiCA alignments, and DORA audit readiness.

Error Handling

All Kakunin error codes, response shapes, and recommended handling patterns. Transient vs permanent, retry strategies, and fallbacks.

On this page

Base URLAgentsCertificatesEventsReportsAudit LogHealthResponse ShapesHTTP Status Codes