Logs & Findings
Retrieve runtime logs and agent-reported findings.
GET /api/v1/logs
Returns log entries starting after the given sequence number.
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
since | integer | 0 | Return entries after this sequence number |
limit | integer | 100 | Maximum entries to return |
Response 200 OK
{
"next_seq": 157,
"logs": [
{
"seq": 155,
"ts": "2026-03-17T10:00:01Z",
"level": "info",
"agent": "log-monitor",
"message": "Scan cycle completed, 3 new entries"
},
{
"seq": 156,
"ts": "2026-03-17T10:00:02Z",
"level": "warn",
"agent": "log-monitor",
"message": "High error rate detected in /var/log/app.log"
}
]
}
Use next_seq as the since value for polling.
GET /api/v1/findings
Returns agent-reported findings (alerts, anomalies, summaries).
Query parameters
| Param | Type | Default | Description |
|---|---|---|---|
since | integer | 0 | Return findings after this sequence number |
limit | integer | 50 | Maximum findings to return |
Response 200 OK
{
"next_seq": 12,
"findings": [
{
"seq": 11,
"ts": "2026-03-17T10:00:02Z",
"agent": "log-monitor",
"severity": "warning",
"title": "Error rate spike",
"detail": "Error rate exceeded 5% threshold in /var/log/app.log"
}
]
}
POST /api/v1/findings
Submit a finding programmatically (typically used by external integrations).
Request body
{
"agent": "external-scanner",
"severity": "info",
"title": "Scan complete",
"detail": "No issues found in latest scan."
}
Response 201 Created
{"seq": 13}