Product Guide
AI Trust Registry Data Contracts
Canonical request/response fields, validation rules, and score snapshot structure.
Last updated Mar 4, 2026
Core Entity Fields
| Field | Type | Required | Notes |
|---|---|---|---|
asset_id | string | conditional | Required when scoring non-agent assets. |
agent_id | string | conditional | Required when scoring autonomous agents. |
owner | string | yes | Team or accountable service owner. |
access_scope | string[] | yes | Permissions and reachable systems. |
attestations | object[] | no | Control and identity attestations. |
evidence | object | yes | Metadata used for confidence calculation. |
Validation Rules
- Exactly one of
asset_idoragent_idmust be set. access_scopemust contain at least one permission string.ownermust map to an authorized tenant domain.- Evidence freshness must be inside policy window for production scoring.
Score Snapshot Schema
{
"entity_id": "agent_42",
"frameworks": {
"provenance": {"score": 72.5, "version": "v0", "source": "connector"},
"mandate": {"score": 58.9, "version": "v0", "source": "control-plane"},
"meridian": {"score": 67.2, "version": "v0", "source": "evidence-pipeline"}
},
"confidence": 0.84,
"risk_band": "high",
"evaluated_at": "2026-03-04T13:30:00Z"
}
Webhook Event Shape (score.updated)
{
"event": "score.updated",
"event_id": "evt_912",
"tenant_id": "tenant_abc",
"entity_id": "agent_42",
"changes": {
"provenance": {"from": 65.1, "to": 72.5},
"confidence": {"from": 0.76, "to": 0.84}
},
"occurred_at": "2026-03-04T13:30:02Z"
}