TRUTH ENGINE Request access

Developers / API

Evaluation API.

A controlled API for approved synthetic scenarios. It is not a production provider API and does not expose private Core architecture.

Access model

Controlled evaluation access.

Approved evaluators receive the API base URL and Bearer credential. The public website does not publish the endpoint or key.

Request headers
Authorization: Bearer $TRUTH_ENGINE_API_KEY
Content-Type: application/json
X-Evaluation-Request-Token: <unique token>

The evaluation request token is required when creating an evaluation.

Routes

The approved public surface.

MethodPathPurpose
GET/v1/scenariosList approved synthetic scenarios.
POST/v1/evaluationsCreate one evaluation.
GET/v1/evaluations/:idRead current justified truth and public evaluation state.
POST/v1/evaluations/:id/retryRequest retry evaluation. This does not imply resend authority.
POST/v1/evaluations/:id/reconcileRun the approved read-only reconciliation path.

Quickstart

Create the flagship evaluation.

Copy each command into Terminal after your evaluation base URL and API key have been provided.

1 · Create evaluation
curl "$TRUTH_ENGINE_API/v1/evaluations" \
  -H "Authorization: Bearer $TRUTH_ENGINE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Evaluation-Request-Token: demo-001" \
  -d '{"scenario":"accepted_then_response_lost"}'
2 · Request retry evaluation
curl -X POST "$TRUTH_ENGINE_API/v1/evaluations/$EVALUATION_ID/retry" \
  -H "Authorization: Bearer $TRUTH_ENGINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
3 · Reconcile
curl -X POST "$TRUTH_ENGINE_API/v1/evaluations/$EVALUATION_ID/reconcile" \
  -H "Authorization: Bearer $TRUTH_ENGINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response model

Only the public evaluation projection.

Private identifiers and private engine internals are not part of the public response.

Example response
{
  "id": "eval_…",
  "scenario": "accepted_then_response_lost",
  "truth": "UNKNOWN",
  "reason": "…",
  "retry": {
    "requested": false,
    "authorized": null,
    "physically_resent": false
  },
  "reconcile": {
    "available": true,
    "attempted": false,
    "caused_provider_mutation": false
  },
  "provider": {
    "effect_requests": 1,
    "durable_effects": 1,
    "lookups": 0
  }
}

Boundaries

This is an evaluation API.

Synthetic provider onlyNo production-use claimNo exactly-once guaranteeNo arbitrary provider destinationReconciliation may remain UNKNOWNControlled access

Evaluation access

Ready to test the API?

Start in the Playground first. Then request controlled API access for a deeper evaluation.

Run PlaygroundRequest access →