Skip to main content
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

Requires X-API-Key header or Bearer JWT token. The workspace is derived from the authenticated credential; do not send X-Tenant-ID.

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

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
agent_id
string
required

MAIP agent identifier (e.g. maip:a0000000:01abc...)

Response

Recomputed trust score

score
number<float>
Required range: 0 <= x <= 1
factors
object
deltas
object
computed_at
string<date-time>