API Reference

curl -X POST https://api.wyrm.ai/v1/jormungandr/decide \
  -H "X-API-Key: $WYRM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "source",
    "product": {
      "query": "1,200 kg primary aluminium ingots",
      "destination_country": "GB"
    }
  }'

import os, requests

resp = requests.post(
    "https://api.wyrm.ai/v1/jormungandr/decide",
    headers={"X-API-Key": os.environ["WYRM_API_KEY"]},
    json={
        "intent": "source",
        "product": {
            "query": "1,200 kg primary aluminium ingots",
            "destination_country": "GB",
        },
    },
    timeout=60,
)
resp.raise_for_status()
print(resp.json()["recommendation"])

const resp = await fetch("https://api.wyrm.ai/v1/jormungandr/decide", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.WYRM_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    intent: "source",
    product: {
      query: "1,200 kg primary aluminium ingots",
      destination_country: "GB",
    },
  }),
});
const decision = await resp.json();

curl -X POST https://api.wyrm.ai/v1/data/intake/parse \
  -H "X-API-Key: $WYRM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "14 MW Tier IV data centre, UK, 12 kW/rack avg, direct-to-chip liquid, N+1"
  }'

Extracts and locks the design constraints — IT load, redundancy, rack density, cooling, jurisdiction — each traced to its source with a confidence score. This is the same intake WYRM MEP runs to drive sizing and deliverables.

curl -X POST https://api.wyrm.ai/v1/data/calcs/facility-energy \
  -H "X-API-Key: $WYRM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "it_load_mw": 14.2,
    "pue_target": 1.28,
    "delta_t_c": 6,
    "redundancy": "N+1"
  }'

Returns facility power, mechanical cooling demand, chilled-water flow, rack count and the cooling-train build-up — an auditable calc pack, identical on every run, never a model's estimate.

curl -X POST https://api.wyrm.ai/v1/data/cable-schedule \
  -H "X-API-Key: $WYRM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "circuits": [
      {
        "ref": "DB-2/6",
        "design_load_kw": 18.5,
        "voltage": 400,
        "length_m": 42,
        "install_method": "C",
        "ambient_c": 30
      }
    ]
  }'

Returns the cable size, breaker rating and volt-drop against the 5% limit, with the BS 7671 clauses applied. Out-of-range inputs are rejected, not guessed — and Amtech / DXF exports are one call further. This is the deterministic engine WYRM MEP sizes against.