API Reference
Full endpoint reference for the Kakunin v1 API.
https://api.kakunin.ai/v1
All requests must include Authorization: Bearer <api_key>.
| Method | Path | Description |
|---|
POST | /agents | Register a new agent |
GET | /agents | List all agents |
GET | /agents/{id} | Get agent details |
POST | /agents/{id}/certify | Issue X.509 certificate |
| Method | Path | Description |
|---|
GET | /certificates | List certificates |
GET | /certificates/{id} | Get certificate |
POST | /certificates/{id}/revoke | Revoke certificate |
| Method | Path | Description |
|---|
POST | /events | Ingest a behaviour event |
GET | /events | Query events (cursor-paginated) |
| Method | Path | Description |
|---|
POST | /reports/compliance | Request a compliance report |
GET | /reports/{id} | Get report status and summary |
GET | /reports/{id}/pdf | Download PDF report |
| Method | Path | Description |
|---|
GET | /audit-log | Query immutable audit trail (cursor-paginated) |
| Method | Path | Description |
|---|
GET | /health | Check API and DB connectivity |
Success:
Error:
{ "error": "Human-readable error message" }
| Code | Meaning |
|---|
200 | Success |
201 | Created |
202 | Accepted (async job queued) |
400 | Invalid input |
401 | Authentication required |
404 | Resource not found |
409 | Conflict (e.g., duplicate active certificate) |
422 | Unprocessable (e.g., certify a retired agent) |
425 | Too Early (report still generating) |
429 | Rate limit exceeded |
500 | Internal server error |
503 | Dependency unavailable (e.g., KMS) |