Governance API

The Governance API is the core integration point for submitting actions for evaluation and retrieving governance results.

Base URL

https://amp.nomotic.ai/api/v1/governance

Submit an evaluation

POST /api/v1/governance/evaluate

This is the primary endpoint your agents call. Every action that needs governance evaluation goes through here.

Request body:

json

{
  "agent_id": "agent_abc123",
  "action": "send_email",
  "target": "customer@example.com",
  "parameters": {
    "subject": "Your order update",
    "recipient_type": "customer"
  },
  "context": {
    "session_id": "session_xyz",
    "request_id": "req_001"
  }
}

Response:

json

{
  "evaluation_id": "eval_789xyz",
  "verdict": "ALLOW",
  "ucs": 0.8234,
  "tier": 1,
  "latency_ms": 0.81,
  "sealed_at": "2026-04-11T14:32:00Z",
  "dimensions": {
    "scope_compliance": 0.95,
    "authority_verification": 0.88,
    "stakeholder_impact": 0.79
  }
}

Get evaluation

GET /api/v1/governance/evaluations/{evaluation_id}

Returns the full evaluation record including all 20 dimension scores and the reasoning artifact.

List evaluations

GET /api/v1/governance/evaluations

Query parameters:

agent_id — filter by agent.

verdict — filter by verdict: ALLOW, ESCALATE, DENY.

from / to — date range in ISO 8601 format.

limit / cursor — pagination.

Get audit trail integrity status

GET /api/v1/governance/audit/integrity

Verifies the hash chain integrity of your organization’s audit trail. Returns a status of valid or compromised, and if compromised, the first record where integrity breaks.

List pending escalations

GET /api/v1/governance/escalations?status=pending

Returns all pending escalations for your organization with full evaluation details.

Resolve an escalation

POST /api/v1/governance/escalations/{evaluation_id}/resolve

Request body: { "decision": "approve" } or { "decision": "deny", "reason": "Outside policy scope" }.