Overview

The Actions API records AI agent actions, triggers jurisdiction evaluation and anomaly scoring, and exposes HalluCase flags. Actions are the atomic units of the chain of custody used in evidence packages.

Endpoints

MethodPathDescription
POST/actionsRecord an action (triggers jurisdiction eval + anomaly scoring)
POST/actions/mcpIngest MCP tool-call action
GET/actions/:idGet action record
GET/actionsList actions (filter by mandate_id, from date)
GET/actions/anomaliesList anomalous actions (HalluCase flags, anomaly scores)

Example

curl -X POST http://localhost:4000/actions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tr_abc123" \
  -d '{"mandate_id":"...","action_type":"access:document"}'