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. 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

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...)

include_factors
boolean
default:true

Whether to include individual factor breakdown

Response

Recomputed trust score

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