Public Resolve API

Returns the latest aligned version of a governed definition, looked up by namespace and id. No authentication required.

Endpoint

GET /api/resolve?namespace=<namespace>&id=<id>

Both parameters are required and must match an aligned record exactly. Unknown ids, unknown namespaces, or mismatched namespace/id pairs return 404.

Pilot namespace — demo concepts

The pilot namespace is the Insurance demo namespace. The following ids resolve to distinct records:

id	label	owner	try
coverage	Coverage	Chief Product Officer	open
claim_event	Claim Event	Head of Claims	open
policyholder	Policyholder	Customer Operations Lead	open
material_damage	Material Damage	Claims Governance Lead	open
risk_exposure	Risk Exposure	Chief Risk Officer	open

Example — 200 OK

// "pilot" = Insurance namespace in the UI
GET /api/resolve?namespace=pilot&id=coverage

200 OK
{
  "id": "coverage",
  "namespace": "pilot",
  "label": "Coverage",
  "definition": "The scope of insurance protection provided under a policy contract, defining which perils, events, and losses the insurer agrees to indemnify, subject to the policy's terms, conditions, exclusions, and limits.",
  "version": "1.0",
  "status": "aligned",
  "owner": "Chief Product Officer",
  "updated_at": "2026-06-12T00:00:00Z"
}

Example — 404 Not Found

GET /api/resolve?namespace=pilot&id=unknown_term_xyz

404 Not Found
{
  "error": "not_found",
  "message": "No definition found for the requested id and namespace"
}

A wrong namespace produces the same 404 — e.g. /api/resolve?namespace=wrong&id=coverage.

Errors

400 — missing id or namespace
404 — no aligned definition found for the supplied id and namespace