Platform API Reference

import requests, time, os

API_KEY = os.environ["AUGEA_API_KEY"]
BASE = "https://augea.org/api/platform/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# Submit job
resp = requests.post(f"{BASE}/clean", headers=HEADERS, json={
    "file_url": "https://my-bucket.s3.amazonaws.com/raw.csv",
    "modality": "tabular",
})
job_id = resp.json()["job_id"]
print(f"Job {job_id} queued")

# Poll until done
while True:
    status = requests.get(f"{BASE}/clean/{job_id}", headers=HEADERS).json()
    if status["status"] in ("completed", "failed"):
        break
    time.sleep(5)

# Download
if status["status"] == "completed":
    data = requests.get(f"{BASE}/clean/{job_id}/download", headers=HEADERS)
    with open("cleaned.csv", "wb") as f:
        f.write(data.content)
    print("Done!")

const API_KEY = process.env.AUGEA_API_KEY!;
const BASE = "https://augea.org/api/platform/v1";
const headers = { Authorization: `Bearer ${API_KEY}` };

// Submit job
const { job_id } = await fetch(`${BASE}/clean`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({
    file_url: "https://my-bucket.s3.amazonaws.com/raw.csv",
    modality: "tabular",
  }),
}).then(r => r.json());

console.log(`Job ${job_id} queued`);

// Poll until done
let status: string;
do {
  await new Promise(r => setTimeout(r, 5000));
  const job = await fetch(`${BASE}/clean/${job_id}`, { headers }).then(r => r.json());
  status = job.status;
} while (status !== "completed" && status !== "failed");

// Download
const file = await fetch(`${BASE}/clean/${job_id}/download`, { headers });
const buffer = await file.arrayBuffer();
Bun.write("cleaned.csv", buffer); // or fs.writeFileSync for Node

# Submit, get job_id, poll, download
JOB=$(curl -s -X POST https://augea.org/api/platform/v1/clean \
  -H "Authorization: Bearer $AUGEA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_url":"https://my-bucket.s3.amazonaws.com/raw.csv"}' | jq -r .job_id)

echo "Polling job $JOB..."
while [ "$(curl -s https://augea.org/api/platform/v1/clean/$JOB \
  -H "Authorization: Bearer $AUGEA_API_KEY" | jq -r .status)" != "completed" ]; do
  sleep 5
done

curl -o cleaned.csv https://augea.org/api/platform/v1/clean/$JOB/download \
  -H "Authorization: Bearer $AUGEA_API_KEY"