POST /v1/clean

# 12 hourly slots; 06:00 is missing. Free dry run: no model call, no points billed.
curl -sS -X POST "https://api.sequenxai.com/v1/clean" \
  -H "Authorization: Bearer $SEQUENX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "freq": "1h",
    "series": [
      {"unique_id": "meter-001", "ds": "2026-09-01T00:00:00Z", "y": 142.5},
      {"unique_id": "meter-001", "ds": "2026-09-01T01:00:00Z", "y": 141.8},
      {"unique_id": "meter-001", "ds": "2026-09-01T02:00:00Z", "y": 140.9},
      {"unique_id": "meter-001", "ds": "2026-09-01T03:00:00Z", "y": 139.7},
      {"unique_id": "meter-001", "ds": "2026-09-01T04:00:00Z", "y": 139.2},
      {"unique_id": "meter-001", "ds": "2026-09-01T05:00:00Z", "y": 138.8},
      {"unique_id": "meter-001", "ds": "2026-09-01T07:00:00Z", "y": 138.2},
      {"unique_id": "meter-001", "ds": "2026-09-01T08:00:00Z", "y": 139.0},
      {"unique_id": "meter-001", "ds": "2026-09-01T09:00:00Z", "y": 140.4},
      {"unique_id": "meter-001", "ds": "2026-09-01T10:00:00Z", "y": 141.3},
      {"unique_id": "meter-001", "ds": "2026-09-01T11:00:00Z", "y": 142.0}
    ]
  }'

import math
import os

import requests

API_URL = "https://api.sequenxai.com/v1/clean"
HEADERS = {"Authorization": f"Bearer {os.environ['SEQUENX_API_KEY']}"}

# 48 hourly slots: 2026-09-01T20:00 is missing and one reading is the logger code -9999.
series = []
for i in range(48):
    if i == 20:
        continue
    y = round(140 + 8 * math.sin(2 * math.pi * i / 24), 1)
    series.append({
        "unique_id": "meter-001",
        "ds": f"2026-09-{1 + i // 24:02d}T{i % 24:02d}:00:00Z",
        "y": -9999 if i == 30 else y,
    })


def dry_run(options=None):
    payload = {"series": series, "freq": "1h", "model": "hora-1.0"}
    if options:
        payload["options"] = options
    resp = requests.post(API_URL, headers=HEADERS, json=payload, timeout=60)
    body = resp.json()
    if resp.status_code != 200:
        error = body["error"]
        raise SystemExit(f"{resp.status_code} {error['code']}: {error['message']} ({error['request_id']})")
    return body


report = dry_run()["cleaning_report"]
for decision in report["decisions"]:
    print(decision["id"], decision["class"], decision["status"])
# value.sentinel:meter-001:-9999 fabricate applied
# grid.regrid:meter-001 structural applied
# gap.impute:meter-001 fabricate applied

# -9999 is a real reading here: decline the decision by its id and look again.
report = dry_run({"cleaning": {"decline": ["value.sentinel:meter-001:-9999"]}})["cleaning_report"]
print([(d["id"], d["status"]) for d in report["decisions"]][0])
# ('value.sentinel:meter-001:-9999', 'declined')

// Node.js 18+. Same 12-slot series as the curl example.
const hours = [0, 1, 2, 3, 4, 5, 7, 8, 9, 10, 11];
const values = [142.5, 141.8, 140.9, 139.7, 139.2, 138.8, 138.2, 139.0, 140.4, 141.3, 142.0];
const series = hours.map((h, i) => ({
  unique_id: "meter-001",
  ds: `2026-09-01T${String(h).padStart(2, "0")}:00:00Z`,
  y: values[i],
}));

const resp = await fetch("https://api.sequenxai.com/v1/clean", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SEQUENX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ series, freq: "1h" }),
});
const body = await resp.json();
if (!resp.ok) throw new Error(`${resp.status} ${body.error.code}: ${body.error.message}`);

console.log(body.effective_policy.id);
for (const d of body.cleaning_report.decisions) {
  console.log(d.id, d.class, d.status, d.before, d.after);
}