Decision API. Live in Production

POST a decision. GET a governed record.

Any system can connect today. Submit a governed decision record before any consequential action. Receive a SHA-256 sealed, hash-chained, permanent record back immediately. First external integration returned a valid record on the first attempt.

Current v1.4 (21 April 2026); prior v1.3 (20 April 2026).

Live
Production status
v1.4
Schema version
MIT
Licence
SHA-256
Hash chain

Base URL: https://omega-governance-api-production.up.railway.app

Endpoints.

POST /decisions

Submit a governed decision record before execution. Returns a SHA-256 sealed record with mandate ID, timestamp, and hash chain reference. The record is permanent and cannot be altered.

Request: application/json
{
  "mandate_id": "VLRW6HUK",
  "schema_version": "1.2",
  "governance": {
    "authorised_agent": "loan-approval-agent-v2",
    "authority_document": "LendingPolicy-v3.2",
    "authority_type": "DELEGATED",
    "constraint_envelope": {
      "max_loan_value": 50000,
      "min_credit_score": 620,
      "no_defaults_months": 36
    },
    "scope_confirmed": true
  },
  "reasoning": {
    "facts": [
      { "claim": "credit_score: 687", "source": "Experian", "confidence": 0.99 },
      { "claim": "income_verified: 42000", "source": "payslip_hash", "confidence": 0.97 }
    ],
    "inference": "applicant meets all policy criteria for standard loan approval",
    "assumptions": [
      { "claim": "income documents are accurate", "confidence": 0.85, "handling": "MONITORED" }
    ],
    "unknowns": ["future employment stability"]
  },
  "expectation": {
    "predicted_outcome": "loan repaid within 48-month term",
    "confidence": "MEDIUM-HIGH",
    "falsifiable": true,
    "evaluation_horizon_months": 6,
    "materiality_variable": "default_probability"
  },
  "confirmation": {
    "gate_type": "AUTOMATED",
    "irreversibility_acknowledged": true
  }
}
Response, 201 Created
{
  "status": "COMMITTED",
  "mandate_id": "VLRW6HUK",
  "record_hash": "sha256:a3f9e2c1d8b7f4c2e9a1d8b3f4c7e2a9...",
  "timestamp": "2026-04-19T14:23:07.002Z",
  "schema_version": "1.2",
  "primitives_verified": 15,
  "protocol_version": "v1.4",
  "conjunct_count": 21,
  "immutable_from": "2026-04-19T14:23:07.002Z"
}
GET /decisions/:mandate_id

Retrieve any governed record by mandate ID. The record is immutable, hash-verifiable, and survives removal of the system that produced it. Decision Sovereignty: the record remains valid even after the authorising entity no longer exists.

Request
GET /decisions/VLRW6HUK
Host: omega-governance-api-production.up.railway.app
Response, 200 OK
{
  "mandate_id": "VLRW6HUK",
  "status": "COMMITTED",
  "record_hash": "sha256:a3f9e2c1d8b7f4c2e9a1d8b3f4c7e2a9...",
  "timestamp": "2026-04-19T14:23:07.002Z",
  "schema_version": "1.2",
  "primitives_verified": 15,
  "protocol_version": "v1.4",
  "conjunct_count": 21,
  "governance": { ... },
  "reasoning": { ... },
  "expectation": { ... },
  "confirmation": { ... },
  "immutable": true,
  "chain_position": 847
}

First external integration: Deliberate Network (Alex Stojanovic), March 2026. POST /decisions with mandate VLRW6HUK. SHA-256 hashed OMEGA record returned first attempt. The standard works in production.

v1.4 records include the 21-conjunct formal bundle verification flag and carry the four structural integrity constraints (P1 freshness, P2 DAG, P6 atomic agency, P4T environment invariant) as validation requirements.

MCP server composability.

The Decision API is exposed as an MCP (Model Context Protocol) server. Any MCP-compatible agent framework — including Claude, Cursor, OpenAI Agents SDK, LangGraph, and the full Linux Foundation-governed agentic ecosystem — can attach a governed OMEGA record to any tool call by calling the MCP server before the tool fires. MCP specifies how the agent accesses the tool. OMEGA specifies what the agent committed to before the tool call. The two layers compose.

See the MCP server page for the full tool surface.

Schema v1.4: required fields.

FieldPrimitiveRequiredDescription
governance.authorised_agentP1YesIdentity of the agent authorised to act
governance.authority_documentP1YesPolicy or document authorising the action
governance.constraint_envelopeP1YesExplicit constraints the action must remain within
reasoning.factsP2YesVerified facts with source and confidence
reasoning.inferenceP2YesThe conclusion reached from facts
reasoning.assumptionsP2YesDeclared assumptions with confidence and handling
reasoning.unknownsP2YesWhat the system could not verify at commitment time
expectation.predicted_outcomeP4YesFalsifiable prediction committed before action
expectation.materiality_variableP4MYesHighest-consequence variable being tracked
confirmation.gate_typeP5YesAUTOMATED, HUMAN, or HYBRID
confirmation.irreversibility_acknowledgedP5YesExplicit acknowledgement this action cannot be undone
delegationP6If delegatingDelegation chain record: governed or ungoverned declaration
trajectoryP4TIf multi-stepAggregate prediction for the entire sequence

The record is sealed at submission. Any field that contains a hash (input_data_hash, model_version_hash) is verified against the chain on retrieval. Modification of any field breaks the chain: detectable immediately.

Quick start: curl.

Submit a governed record in one command
curl -X POST \
  https://omega-governance-api-production.up.railway.app/decisions \
  -H "Content-Type: application/json" \
  -d '{
    "mandate_id": "TEST-001",
    "schema_version": "1.2",
    "governance": {
      "authorised_agent": "my-agent-v1",
      "authority_document": "MyPolicy-v1.0",
      "constraint_envelope": { "scope": "test" },
      "scope_confirmed": true
    },
    "reasoning": {
      "facts": [{ "claim": "test condition met", "confidence": 0.99 }],
      "inference": "proceed with test action",
      "assumptions": [],
      "unknowns": []
    },
    "expectation": {
      "predicted_outcome": "test completes successfully",
      "confidence": "HIGH",
      "falsifiable": true,
      "materiality_variable": "completion_status"
    },
    "confirmation": {
      "gate_type": "AUTOMATED",
      "irreversibility_acknowledged": false
    }
  }'