REST API

# 1. Create a design from a plain-English description
curl -X POST https://api.voxelspatiallabs.com/v1/designs \
  -H "Authorization: Bearer $ANUBIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spec": "A rover that patrols a two-hectare vegetable farm, photographs every bed each morning and returns to its charger."}'
# -> {"design_id": "..."}

# 2. Start a run
curl -X POST https://api.voxelspatiallabs.com/v1/designs/$DESIGN_ID/runs \
  -H "Authorization: Bearer $ANUBIS_API_KEY"
# -> {"run_id": "..."}

# 3. Poll until the run completes or a gate blocks it
curl https://api.voxelspatiallabs.com/v1/runs/$RUN_ID \
  -H "Authorization: Bearer $ANUBIS_API_KEY"

# 4. Fetch the bill of materials as CSV
curl "https://api.voxelspatiallabs.com/v1/designs/$DESIGN_ID/bom?format=csv" \
  -H "Authorization: Bearer $ANUBIS_API_KEY" -o bom_full.csv

import os
import time

import requests

BASE = "https://api.voxelspatiallabs.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ANUBIS_API_KEY']}"}

# 1. Create a design from a plain-English description
design = requests.post(
    f"{BASE}/designs",
    headers=HEADERS,
    json={"spec": "A rover that patrols a two-hectare vegetable farm, "
                  "photographs every bed each morning and returns to its charger."},
).json()
design_id = design["design_id"]

# 2. Start a run
run = requests.post(f"{BASE}/designs/{design_id}/runs", headers=HEADERS).json()
run_id = run["run_id"]

# 3. Poll until the run completes or a gate blocks it (runs take minutes to hours)
while True:
    status = requests.get(f"{BASE}/runs/{run_id}", headers=HEADERS).json()
    if status["state"] in ("completed", "blocked", "failed"):
        break
    time.sleep(30)

# 4. Fetch the bill of materials
bom = requests.get(f"{BASE}/designs/{design_id}/bom", headers=HEADERS).json()
for line in bom["lines"]:
    print(line["part"], line["mpn"], line["quantity"])

const BASE = "https://api.voxelspatiallabs.com/v1";
const headers = {
  Authorization: `Bearer ${process.env.ANUBIS_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Create a design from a plain-English description
const { design_id } = await fetch(`${BASE}/designs`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    spec: "A rover that patrols a two-hectare vegetable farm, photographs every bed each morning and returns to its charger.",
  }),
}).then((r) => r.json());

// 2. Start a run
const { run_id } = await fetch(`${BASE}/designs/${design_id}/runs`, { method: "POST", headers }).then((r) => r.json());

// 3. Poll until the run completes or a gate blocks it (runs take minutes to hours)
let status;
do {
  await new Promise((resolve) => setTimeout(resolve, 30_000));
  status = await fetch(`${BASE}/runs/${run_id}`, { headers }).then((r) => r.json());
} while (!["completed", "blocked", "failed"].includes(status.state));

// 4. Fetch the bill of materials
const bom = await fetch(`${BASE}/designs/${design_id}/bom`, { headers }).then((r) => r.json());
for (const line of bom.lines) console.log(line.part, line.mpn, line.quantity);