Taskbox

# Once per account. The keys are stored encrypted and are
# never returned by any endpoint — only whether they are set.
# llmKey is optional: leave it out and the model is on us for a few runs a day.
curl -X PUT "$BOXIE_API/v1/taskbox/config" \
  -H "Authorization: Bearer $BOXIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tregKey": "<your treg key>", "llmKey": "<anthropic or openai key>"}'

# -> {"tregConfigured": true, "llmConfigured": true,
#     "llmProvider": "anthropic", "llmSource": "Taskbox key",
#     "tregKeyExpiresAt": "2026-09-22T21:43:46Z"}

# No keys in the request — your account already has them.
# Returns immediately so a long task cannot be lost to a timeout.
curl -X POST "$BOXIE_API/v1/taskbox/runs" \
  -H "Authorization: Bearer $BOXIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Find the cheapest paid Google Maps tool and its price."}'

# -> HTTP 202
#    {"runId": "run_PvHPfLCrfeK_KERgZKg6WA", "status": "running",
#     "agentEnabled": true, "createdAt": "2026-08-24T01:27:21Z"}

# Poll until status leaves "running" (about 2s between polls).
curl "$BOXIE_API/v1/taskbox/runs/$RUN_ID" \
  -H "Authorization: Bearer $BOXIE_API_KEY"

# -> {"status": "succeeded",
#     "answer": "The single cheapest paid Google Maps tool is
#                dataforseo.x.serp-google-maps-live-advanced at $0.002/call.",
#     "toolCalls": [{"tool": "treg_catalog_search", "exit": 0}],
#     "durationMs": 6799}
#
# The workspace that produced this was already destroyed. There is no
# URL or token to keep, and nothing to clean up.

// The same two calls from your own backend.
const headers = {
  Authorization: `Bearer ${process.env.BOXIE_API_KEY}`,
  "Content-Type": "application/json",
};

const started = await fetch(`${API}/v1/taskbox/runs`, {
  method: "POST",
  headers,
  body: JSON.stringify({ prompt: "Find the cheapest paid Google Maps tool." }),
}).then((r) => r.json());

let run = started;
while (run.status === "running") {
  await new Promise((r) => setTimeout(r, 2000));
  run = await fetch(`${API}/v1/taskbox/runs/${started.runId}`, {
    headers,
  }).then((r) => r.json());
}
console.log(run.answer);