Which API should I call?
Pick the gateway route by intent, not internal package names.
| Intent | Path | SandboxClient |
|---|---|---|
| Benchmark / verifier / Harbor task | /sandbox/harbor/... | run_datapoint(...) |
| Run code once (no LLM) | /sandbox/codeedit/v1/executions | run_code_execution(...) |
| Ad-hoc coding agent (LLM) | /sandbox/agent/v1/runs | run_agent(...) |
| Browser automation | /sandbox/browser/v1/sessions | create_browser_session() |
| CI in sandbox | /sandbox/cirunner/v1/runs | start_ci_run(...) |
| Discover agents / languages | /sandbox/v1/catalog?kind=... | catalog(kind=...) |
| Catalog + Harbor factory union | /sandbox/agent/v1/agents | — |
| Admin keys / teams | /sandbox/v1/admin/credential-plane/... | HTTP admin only |
Decision tree
L4 rule
Products use SandboxClient only — no direct harbor-worker URLs in production.