DecisionVault
DEVELOPER PLATFORM • API VERSION 1.4 • OPENAPI 3.1

DecisionVault API Reference

Programmatically interface with DecisionVault’s 34B neural decision graphs, perform vector precedent lookups, and automate fiduciary invariant audits.

Base URL: https://api.decision-vault.com/v1
STEP 1

Quickstart Integration

The DecisionVault API lets you integrate neural decision intelligence directly into your fintech workflows, treasury automation, or DevOps orchestration pipelines in under 5 minutes.

PYTHON SDK
pip install decisionvault-sdk
NODE.JS / TYPESCRIPT SDK
npm install @decisionvault/sdk
STEP 2

Authentication

Authenticate all API requests by including your secret API token in the Authorization HTTP header.

Authorization: Bearer dv_live_894f29a0e1c2b5768ad
Security Notice: Keep your secret keys secure. Never expose live keys in client-side browser JavaScript or public GitHub repositories.
POST /v1/decisions/evaluate

Submits a proposed corporate, architectural, or financial decision payload to the Vault-34B neural graph model for downside risk scoring, precedent alignment, and fiduciary compliance checks.

REQUEST EXAMPLE (CURL)
curl -X POST https://api.decision-vault.com/v1/decisions/evaluate \
  -H "Authorization: Bearer dv_live_894f29a0e1c2b5768ad" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Active-Active Multi-Region AWS Migration",
    "capital_at_stake_usd": 12000000,
    "domain": "CLOUD_INFRASTRUCTURE",
    "fiduciary_stance": "BALANCED",
    "confidence_threshold": 0.95
  }'
RESPONSE (STATUS 200 OK • LATENCY 38ms)
{
  "status": "success",
  "decision_id": "dec_892fd09b2e7",
  "timestamp": "2026-10-18T12:30:00Z",
  "execution_time_ms": 38.4,
  "precedent_match": {
    "confidence_score": 0.994,
    "cluster_id": "CLUST_AWS_INFRA_2026",
    "similar_precedents_found": 84,
    "top_precedent": "Active-Active Multi-Region AWS Architecture"
  },
  "fiduciary_risk_assessment": {
    "risk_level": "LOW",
    "downside_probability": 0.042,
    "projected_net_roi_percent": 34.2,
    "compliance_status": "APPROVED_SOC2_HIPAA_ISO27001"
  },
  "cryptographic_merkle_root": "0x9a4f21b7c093a8d167e42df0819c9e88"
}
REAL-TIME TELEMETRY

Webhooks & Event Streaming

Subscribe your internal endpoints to receive immediate asynchronous notifications when risk thresholds are breached or precedents are validated.

decision.breach_detected Fired when an active initiative drifts beyond pre-agreed risk boundaries.
precedent.sealed Fired when an enterprise decision is cryptographically sealed in the vault.
outcome.audited Fired upon completion of a 12 or 18-month post-decision retrospective audit.
ERROR CODES

HTTP Status Codes

Status Meaning Description
200 OK Success Evaluation or vector query completed successfully.
400 Bad Request Validation Error Missing required payload fields or malformed JSON.
401 Unauthorized Invalid Token API key is missing or invalid.
429 Rate Limit Quota Exceeded Monthly evaluation limit reached. Upgrade tier in dashboard.