List All Agent Trust Records — GET /v1/trust/agents

Retrieve trust records for all agents, including reputation score and blocklist status. Blocked agents are rejected at invocation time.

Returns the current trust record for every known agent. Use this endpoint to audit reputation scores and identify blocked agents before invoking them.

Response

Returns { "items": [AgentTrustRecord] }.

items · array

Array of AgentTrustRecord objects, one per known agent.

Show AgentTrustRecord

agent_id · string · required

The unique identifier of the agent.

reputation_score · number (float) · required

Current reputation score for this agent, derived from invocation history and verification outcomes.

blocked · boolean · required

Whether this agent is currently blocked. Invocations against a blocked agent return HTTP 403.

block_reason · string

Human-readable explanation of why the agent was blocked. Present only when blocked is true.

updated_at · string (ISO 8601) · required

UTC timestamp of the most recent update to this trust record.

Example

curl http://your-node:8042/v1/trust/agents

Example response

{
  "items": [
    {
      "agent_id": "stripe-agent",
      "reputation_score": 0.97,
      "blocked": false,
      "updated_at": "2025-01-15T10:35:00Z"
    },
    {
      "agent_id": "legacy-agent",
      "reputation_score": 0.41,
      "blocked": true,
      "block_reason": "policy violation",
      "updated_at": "2025-01-14T08:00:00Z"
    }
  ]
}