Compute Trust Score

Recompute the trust score for a machine agent based on current behavioral signals

Triggers an on-demand recomputation of the trust score for a specific agent. The score is derived from multiple weighted factors including anomaly rate, uptime history, delegation depth, and receipt volume. Use this endpoint after a significant event (key rotation, policy violation, attestation burst) to ensure the score reflects the agent’s current posture.

Trust scores range from 0.0 (no trust) to 1.0 (full trust) and are used by policy engines, witness selection, and delegation gates across the platform.

Authentication

Requires X-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.

Path Parameters

agent_id · string · required

The unique identifier of the machine agent whose trust score should be recomputed. Format: maip-agent:ULID.

Request Body

include_history · boolean · default: "false"

When true, the response includes the full factor history used during computation. Useful for debugging score changes but increases response size.

Response

agent_id · string

The agent identifier that was scored.

score · number

The computed trust score as a float between 0.0 and 1.0.

factors · object

Breakdown of the individual factors that contributed to the score.

Show Factor fields

factors.anomaly_rate · number

Ratio of anomalous events to total events in the scoring window. Lower is better.

factors.uptime · number

Agent availability ratio over the last 30 days. 1.0 means 100% uptime.

factors.delegation_depth · integer

Current depth of the agent’s delegation chain. Deep chains reduce trust.

factors.receipt_count · integer

Total number of valid receipts the agent has accumulated.

computed_at · string

ISO 8601 timestamp of when the computation completed.

Score Factor Weights

Factor	Weight	Description
anomaly_rate	30%	Penalizes agents with high anomaly ratios
uptime	25%	Rewards consistent availability
delegation_depth	20%	Deeper chains reduce trust proportionally
receipt_count	25%	More receipts indicate established history