API Reference / agent-controller

Findings inbox across every agent

get https://api.intelig.ai/api/v1/intelig/agents/findings/inbox

Auth: Authorization: ApiKey <key> (an API key sent as Bearer is rejected) or Authorization: Bearer <jwt> for a dashboard session. operationId: getFindingsInbox

Paginated, filterable view of what every agent has concluded for this organization — the read an external client should poll rather than walking each agent in turn. Filter by agent, severity, time window, or unacknowledged-only. Requires the `agent:read` scope.

Example request

curl -X GET "https://api.intelig.ai/api/v1/intelig/agents/findings/inbox" \
  -H "Authorization: ApiKey $INTELIG_API_KEY"

Query parameters

NameTypeRequiredDescription
agentName string no
severity string no
from string (date-time) no
to string (date-time) no
unacknowledgedOnly boolean no
page integer (int32) no
pageSize integer (int32) no

Response 200

application/json · ApiResponseFindingsInboxDto

FieldTypeDescription
success boolean
message string
data FindingsInboxDto

Status codes

  • 200 — OK
  • 401 — —
  • 404 — Not Found
  • 429 — —

Every response is wrapped in { success, message, data }. A 4xx means the request is wrong — do not retry it unchanged. A 429 carries Retry-After in seconds.