REST API Reference

curl -X POST https://api.arda.vareon.com/v1/projects \
  -H "Authorization: Bearer arda_key_sk_live_7f3a9b2c..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Turbulence Dynamics Study",
    "description": "Discover governing equations for turbulent flow regimes",
    "settings": {
      "default_mode": "neuro_symbolic",
      "governance": {
        "promotion_ceiling": "validate",
        "require_negative_controls": true,
        "truth_dial_threshold": 0.85
      }
    }
  }'

{
  "id": "proj_tds_8f2a1b",
  "name": "Turbulence Dynamics Study",
  "description": "Discover governing equations for turbulent flow regimes",
  "status": "active",
  "settings": {
    "default_mode": "neuro_symbolic",
    "governance": {
      "promotion_ceiling": "validate",
      "require_negative_controls": true,
      "truth_dial_threshold": 0.85
    }
  },
  "created_at": "2026-03-28T10:15:30Z",
  "updated_at": "2026-03-28T10:15:30Z",
  "created_by": "usr_faruk_01",
  "tenant_id": "ten_vareon_prod"
}

curl -X POST https://api.arda.vareon.com/v1/projects/proj_tds_8f2a1b/campaigns \
  -H "Authorization: Bearer arda_key_sk_live_7f3a9b2c..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Reynolds Number Sweep",
    "description": "Systematic sweep across Re = 1000-10000",
    "budget": {
      "compute_units": 2500,
      "max_runs": 50,
      "expires_at": "2026-06-01T00:00:00Z"
    },
    "governance": {
      "promotion_ceiling": "validate",
      "require_negative_controls": true,
      "auto_promote_to": "explore"
    }
  }'

curl -X POST https://api.arda.vareon.com/v1/projects/proj_tds_8f2a1b/campaigns/camp_rns_4e8f2a/runs \
  -H "Authorization: Bearer arda_key_sk_live_7f3a9b2c..." \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "neuro_symbolic",
    "dataset_id": "ds_turb_001",
    "parameters": {
      "target_variables": ["velocity_x", "velocity_y", "pressure"],
      "constraints": ["conservation_of_energy", "navier_stokes"],
      "max_complexity": 5,
      "symbolic_prior": "polynomial",
      "neural_backbone": "transformer",
      "epochs": 200,
      "cross_validate": true
    },
    "governance": {
      "negative_controls": ["shuffle_test", "permutation_test"],
      "evidence_threshold": 0.9
    }
  }'

{
  "id": "run_ns_7a3b2c",
  "project_id": "proj_tds_8f2a1b",
  "campaign_id": "camp_rns_4e8f2a",
  "mode": "neuro_symbolic",
  "dataset_id": "ds_turb_001",
  "status": "queued",
  "created_at": "2026-03-28T10:45:00Z",
  "parameters": { "...": "as submitted" },
  "compute_units_estimated": 45
}

GET /v1/projects/proj_tds_8f2a1b/campaigns/camp_rns_4e8f2a/runs/run_ns_7a3b2c/status

{
  "id": "run_ns_7a3b2c",
  "status": "running",
  "pipeline": {
    "current_stage": "symbolic_regression",
    "stages": [
      {"name": "data_validation", "status": "completed", "duration_ms": 1200},
      {"name": "feature_extraction", "status": "completed", "duration_ms": 8400},
      {"name": "neural_pretraining", "status": "completed", "duration_ms": 45000},
      {"name": "symbolic_regression", "status": "running", "progress": 0.67},
      {"name": "negative_controls", "status": "pending"},
      {"name": "claim_generation", "status": "pending"}
    ]
  },
  "compute_units_used": 32,
  "started_at": "2026-03-28T10:45:05Z",
  "estimated_completion": "2026-03-28T11:02:00Z"
}

GET /v1/projects/proj_tds_8f2a1b/claims?run_id=run_ns_7a3b2c&limit=2

{
  "object": "list",
  "data": [
    {
      "id": "clm_law_9d4e5f",
      "type": "law",
      "tier": "explore",
      "summary": "∂u/∂t + (u·∇)u = -∇p/ρ + ν∇²u",
      "expression": "du/dt = -grad(p)/rho + nu * laplacian(u) - (u . grad)(u)",
      "score": 0.94,
      "scope": {
        "variables": ["velocity_x", "velocity_y", "pressure"],
        "domain": "Re ∈ [1000, 10000]",
        "constraints_satisfied": ["conservation_of_energy", "navier_stokes"]
      },
      "evidence": {
        "r_squared": 0.97,
        "negative_controls_passed": true,
        "cross_validation_score": 0.93
      },
      "ledger_entry_id": "led_a1b2c3",
      "run_id": "run_ns_7a3b2c",
      "created_at": "2026-03-28T11:01:45Z"
    },
    {
      "id": "clm_causal_2f8g3h",
      "type": "causal",
      "tier": "explore",
      "summary": "Pressure gradient drives velocity field evolution",
      "cause": "pressure_gradient",
      "effect": "velocity_field",
      "direction": "unidirectional",
      "temporal_scope": "instantaneous",
      "intervention_markers": ["pressure_boundary_perturbation"],
      "score": 0.88,
      "scope": {
        "variables": ["pressure", "velocity_x", "velocity_y"],
        "domain": "Re ∈ [1000, 10000]"
      },
      "evidence": {
        "granger_score": 0.91,
        "intervention_effect_size": 0.85,
        "negative_controls_passed": true
      },
      "ledger_entry_id": "led_d4e5f6",
      "run_id": "run_ns_7a3b2c",
      "created_at": "2026-03-28T11:01:50Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0yOFQxMTowMTo1MFoifQ=="
}

curl -X POST https://api.arda.vareon.com/v1/projects/proj_tds_8f2a1b/claims/clm_law_9d4e5f/promote \
  -H "Authorization: Bearer arda_key_sk_live_7f3a9b2c..." \
  -H "Content-Type: application/json" \
  -d '{
    "target_tier": "validate",
    "rationale": "Passed all negative controls, cross-validated on held-out data, consistent with known Navier-Stokes formulation."
  }'

curl -X POST https://api.arda.vareon.com/v1/projects/proj_tds_8f2a1b/datasets \
  -H "Authorization: Bearer arda_key_sk_live_7f3a9b2c..." \
  -F "file=@turbulence_data.parquet" \
  -F 'metadata={"name":"Turbulence Re=5000","format":"parquet","variables":["velocity_x","velocity_y","pressure","time"]}'

{
  "id": "ds_turb_001",
  "name": "Turbulence Re=5000",
  "format": "parquet",
  "status": "profiling",
  "size_bytes": 15728640,
  "rows": 250000,
  "variables": ["velocity_x", "velocity_y", "pressure", "time"],
  "created_at": "2026-03-28T09:00:00Z",
  "profile_ready": false
}