REST endpoints

The REST API exposes the agent → session → decision hierarchy under /v1. All endpoints require a bearer token (Authentication) and are tenant-scoped.

For interactive analysis and natural-language queries, prefer the MCP server — it offers richer filtering and rollups than the raw REST endpoints.

List agents

GET /v1/agents

Returns agents visible to the caller with rollup metrics (decision count, cost, confidence, activity dates).

GET /v1/agents/{agent_id}/sessions

Returns the sessions for one agent, with aggregate stats and AI summaries.

string

required

Agent identifier from GET /v1/agents.

GET /v1/sessions/{session_id}

Returns a single session with its aggregate stats and health view.

string

required

GET /v1/sessions/{session_id}/decisions/{ledger_id}

Returns the full audit trail for one decision — the logic trace, evidence, findings, and artifacts.

string

required

uuid

required

The decision’s ledger_id.

curl https://data.enfors.ai/v1/agents/claude_desktop_misha/sessions \
  -H "Authorization: Bearer enf_live_xxxxxxxx"

The data shapes returned here mirror the MCP tool responses. See the Data model for field definitions.