JSON Specifications

The Versioned Decision Object Schema

Explore the strict schema standards used to define inbound Execution Intents and returned hypervisor authorizations.

Inbound Intent PayloadPOST /v1/decisions

{
  "schema_version": "dh.execution-intent.v1",
  "tenant_id": "acme",
  "environment_id": "production",
  "principal": { "type": "organization", "id": "org_acme" },
  "requestor": { "type": "agent", "id": "agt_refund_v4" },
  "action": {
    "namespace": "payments",
    "name": "refund",
    "version": 1
  },
  "target": "txn_stripe_9918",
  "purpose": "customer_refund",
  "parameters": { "amount": 24900, "currency": "USD" },
  "requested_at": "2026-07-27T12:00:00Z",
  "idempotency_key": "dec_01J4X7A",
  "execution_mode": "enforced"
}

*The contract sets additionalProperties: false — unknown or malformed fields are rejected at the boundary. Condensed from the public OpenAPI 3.1 contract.

Hypervisor Resolutiondh.decision.v1

{
  "schema_version": "dh.decision.v1",
  "decision_id": "dec_01J4X7A",
  "lifecycle_state": "resolved",
  "resolution": "AUTHORIZED | MODIFIED | ESCROWED
               | REVIEW_REQUIRED | ROUTED | DENIED",
  "reasons": [
    { "code": "policy.allow", "summary": "...",
      "policy_id": "pol_financial_v4", "remediation": null }
  ],
  "obligations": [],
  "execution_grant_id": "egr_9f2c…",
  "trace_id": "trc_01J4X7A",
  "integrity": {
    "canonical_digest": "sha256:…",
    "schema_digest": "sha256:…"
  }
}

*Authorized decisions carry an Ed25519-signed execution grant (JWS/EdDSA) that target connectors verify offline — no call home required. Condensed from the public OpenAPI 3.1 contract.