API ReferenceStable v1

API Overview

Canonical Ethira adapter endpoint contracts from the published OpenAPI artifact.

Last updated Mar 6, 2026

Base URL and Versioning

Score operations base path:

/v1

Include Authorization and X-Tenant-Id in write operations.

Canonical Product Mapping

AI Trust Registry = Provenance + Mandate + Meridian
Contract Assurance Monitor = Fidelity + Mandate + Meridian
Runtime Alignment Monitor = Drift + Fidelity + Mandate + Meridian + Threshold

Cross-product capability layer:

Runtime Enforcement & Resilience = Threshold + Drift + Fidelity + Mandate + Meridian

Endpoint Reference

GET/healthzNone

Health check endpoint for adapter availability.

Response

200 JSON object with status fields.

POST/v1/assets/scoreBearer + X-Tenant-Id

Score a discovered asset for trust-registry prioritization.

Required request fields

Field	Type
`tenant_id`	`string`
`asset_id`	`string`
`event_id`	`string`
`score_version`	`string`
`evidence_events`	`TrustRegistryEvidenceEvent[]`

Optional fields

Field	Type
`discovery_confidence`	`number` (0-1)
`control_readiness`	`number` (0-1)

POST/v1/agents/scoreBearer + X-Tenant-Id

Score an agent for trust-registry prioritization.

Required request fields

Field	Type
`tenant_id`	`string`
`agent_id`	`string`
`event_id`	`string`
`score_version`	`string`
`evidence_events`	`TrustRegistryEvidenceEvent[]`

Optional fields

Field	Type
`identity_confidence`	`number` (0-1)
`oversight_readiness`	`number` (0-1)

POST/v1/contracts/obligations/scoreBearer + X-Tenant-Id

Score contractual obligation fulfillment and breach risk.

Required request fields

Field	Type
`tenant_id`	`string`
`contract_id`	`string`
`obligation_id`	`string`
`control_id`	`string`
`entity_id`	`string`
`event_id`	`string`
`score_version`	`string`
`evidence_events`	`ObligationEvidenceEvent[]`

Optional fields

Field	Type
`control_effectiveness`	`number` (0-1)
`stake`	`ObligationStakeContext`

POST/v1/runtime/analyzeBearer + X-Tenant-Id

Analyze runtime anomaly posture and emit a recommended action.

Required request fields

Field	Type
`tenant_id`	`string`
`entity_id`	`string`
`event_id`	`string`
`score_version`	`string`
`anomaly_score`	`number` (0-1)

GET/v1/score/{framework}/{entity_id}Bearer + X-Tenant-Id

Fetch the latest stored score snapshot for a framework/entity pair.

Path params

Param	Type
`framework`	`string`
`entity_id`	`string`

Response includes

Field
`tenant_id`, `framework`, `entity_id`
`score_snapshot_id`, `evidence_event_id`, `event_id`
`score_version`, `score_payload`, `created_at`

Enforcement-Layer Note

Runtime Enforcement & Resilience uses runtime and contract score outputs plus signed events to apply policy modes (alert, shadow, soft_block, hard_block) in Ethira control-plane workflows.