Recompute Trust Score
Trust & Witness
Compute Trust Score
Recompute the trust score for a machine agent based on current behavioral signals
POST
Recompute Trust Score
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
RequiresX-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.
Path Parameters
string
required
The unique identifier of the machine agent whose trust score should be
recomputed. Format:
maip-agent:ULID.Request Body
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
string
The agent identifier that was scored.
number
The computed trust score as a float between
0.0 and 1.0.object
Breakdown of the individual factors that contributed to the score.
string
ISO 8601 timestamp of when the computation completed.
Score Factor Weights
Authorizations
API key for machine-to-machine authentication
Body
application/json

