Vigil Platform API v1

import requests
r = requests.get("https://yourdomain.com/devices/",
    headers={"X-API-Key": "<key>"})
devices = r.json()["results"]

const r = await fetch("/devices/", {
  headers: { "X-API-Key": "<key>" }
});
const { results: devices } = await r.json();

r = requests.get(f"https://yourdomain.com/devices/{device_id}/",
    headers={"X-API-Key": "<key>"})
device = r.json()

const device = await (await fetch(`/devices/${deviceId}/`,
  { headers: { "X-API-Key": "<key>" } })).json();

r = requests.get(f"https://yourdomain.com/devices/{device_id}/latest/",
    headers={"X-API-Key": "<key>"})
latest = r.json()["readings"]

const { readings } = await (await fetch(`/devices/${deviceId}/latest/`,
  { headers: { "X-API-Key": "<key>" } })).json();

r = requests.get("https://yourdomain.com/sites/",
    headers={"X-API-Key": "<key>"})
sites = r.json()["results"]

const { results: sites } = await (await fetch("/sites/",
  { headers: { "X-API-Key": "<key>" } })).json();

r = requests.get(f"https://yourdomain.com/sites/{site_id}/",
    headers={"X-API-Key": "<key>"})
site = r.json()

import requests
r = requests.post(
    "https://yourdomain.com/trace/query/",
    headers={"X-API-Key": "<key>"},
    json={
        "binding_ids": ["<binding-uuid>"],
        "start": "2026-04-13T09:00:00Z",
        "end":   "2026-04-13T12:00:00Z",
        "max_points": 180,
    }
)
series = r.json()["series"]

const r = await fetch("/trace/query/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "<key>"
  },
  body: JSON.stringify({
    binding_ids: ["<binding-uuid>"],
    start: "2026-04-13T09:00:00Z",
    end:   "2026-04-13T12:00:00Z",
    max_points: 180
  })
});
const { series } = await r.json();

r = requests.get(
    "https://yourdomain.com/status-board/api/",
    headers={"X-API-Key": "<key>"},
    params={"site": "<site-uuid>"}
)
cards = r.json()["cards"]
critical = [c for c in cards if c["alert_state"] == "critical"]

// Poll every 10 seconds
async function pollStatus() {
  const r = await fetch("/status-board/api/", {
    headers: { "X-API-Key": "<key>" }
  });
  const { cards } = await r.json();
  const critical = cards.filter(c => c.alert_state === "critical");
  console.log(`${critical.length} critical alerts`);
}
setInterval(pollStatus, 10_000);

r = requests.get("https://yourdomain.com/alerts/",
    headers={"X-API-Key": "<key>"},
    params={"status": "active", "severity": "critical"})
events = r.json()["events"]

const r = await fetch("/alerts/?status=active&severity=critical",
  { headers: { "X-API-Key": "<key>" } });
const { events } = await r.json();

r = requests.get(f"https://yourdomain.com/alerts/{event_id}/",
    headers={"X-API-Key": "<key>"})
alert = r.json()

const alert = await (await fetch(`/alerts/${eventId}/`,
  { headers: { "X-API-Key": "<key>" } })).json();

import sseclient, requests, json

resp = requests.get("https://yourdomain.com/alerts/stream/",
    headers={"X-API-Key": "<key>"}, stream=True)

for event in sseclient.SSEClient(resp):
    if event.event == "alert":
        alert = json.loads(event.data)
        print(f"ALERT: {alert['device']} — {alert['severity']}")

r = requests.get("https://yourdomain.com/alerts/rules/",
    headers={"X-API-Key": "<key>"})
rules = r.json()["rules"]

const { rules } = await (await fetch("/alerts/rules/",
  { headers: { "X-API-Key": "<key>" } })).json();

r = requests.get("https://yourdomain.com/canvas/",
    headers={"X-API-Key": "<key>"})
dashboards = r.json()["dashboards"]

const { dashboards } = await (await fetch("/canvas/",
  { headers: { "X-API-Key": "<key>" } })).json();

<!-- Embed in an iframe -->
<iframe
  src="https://yourdomain.com/canvas/public/<token>/"
  width="100%" height="600"
  frameborder="0"
  allowfullscreen>
</iframe>

const r = await fetch(`/canvas/public/${token}/query/`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    binding_ids: ["<uuid>"],
    start: new Date(Date.now() - 3600_000).toISOString(),
    end:   new Date().toISOString(),
  })
});
const { series } = await r.json();

r = requests.post("https://yourdomain.com/api/v1/ai/nlq/",
    headers={"X-API-Key": "<key>"},
    json={"question": "What was the peak vibration on Pump 1 this month?"})
result = r.json()
print(result["answer"])   # plain-English answer
print(result["sql"])      # generated SQL

const r = await fetch("/api/v1/ai/nlq/", {
  method: "POST",
  headers: { "Content-Type": "application/json", "X-API-Key": "<key>" },
  body: JSON.stringify({ question: "Show CO2 trends for floor 2 this week" })
});
const { answer, sql, chart_data } = await r.json();

import json, requests

resp = requests.post(
    "https://yourdomain.com/api/v1/ai/argus/message/",
    headers={"X-API-Key": "<key>"},
    json={"message": "What is the current vibration level on Pump 1?"},
    stream=True,
)
for line in resp.iter_lines():
    if not line or not line.startswith(b"data: "):
        continue
    ev = json.loads(line[6:])
    if ev["event"] == "token":
        print(ev["text"], end="", flush=True)
    elif ev["event"] == "done":
        print(f"\n[conversation: {ev['conversation_id']}]")
        break

r = requests.get("https://yourdomain.com/api/v1/ai/argus/conversations/",
    headers={"X-API-Key": "<key>"})
conversations = r.json()["conversations"]

# Search
r = requests.get("https://yourdomain.com/api/v1/ai/argus/memory/",
    headers={"X-API-Key": "<key>"},
    params={"q": "bearing failure"})
memories = r.json()["memories"]

# Create
r = requests.post("https://yourdomain.com/api/v1/ai/argus/memory/",
    headers={"X-API-Key": "<key>"},
    json={"content": "CO2 sensor on Floor 2 prone to drift",
          "memory_type": "observation", "salience": 0.7})

r = requests.get("https://yourdomain.com/api/v1/ai/argus/investigations/",
    headers={"X-API-Key": "<key>"})
invs = [i for i in r.json()["investigations"] if i["status"] == "complete"]

r = requests.get("https://yourdomain.com/prism/fields/",
    headers={"X-API-Key": "<key>"})
fields = r.json()["fields"]

r = requests.get(f"https://yourdomain.com/prism/{field_id}/data/",
    headers={"X-API-Key": "<key>"},
    params={"start": "2026-04-13T00:00:00Z"})
data = r.json()