Logs and waiting
A long log does not have to go into your agent's context, and nobody has to ask “is it done yet?” in a loop – read a compact digest and let the server wait for you.
Log digest for AI
GET /v1/jobs/{id}/logs?mode=summary&max_chars=6000 returns a compact digest: recognised test results, the error lines with context (repeated lines collapsed, e.g. [×200]) and the end of the log. mode=errors returns only the error blocks, mode=tail only the end; without mode you get raw bytes.
print(job.digest(mode="summary", max_chars=2000))
print(job.test_results())
for chunk in job.follow(): # new log text while it runs
print(chunk, end="")
curl -s -H "X-API-Key: $WBXSANDBOX_API_KEY" "https://sandbox.wbx.cz/v1/jobs/job_…/logs?mode=summary&max_chars=2000"
{
"mode": "summary", "status": "failed", "exit_code": 1, "lines": 5214, "size": 412880,
"text": "[wbx] tests (pytest): 211 passed, 1 failed, 212 total\n FAILED tests/test_api.py::test_refund – AssertionError: 400 != 200\n[wbx] errors:\n…\n[wbx] end of log:\n…",
"test_results": [{"framework": "pytest", "passed": 211, "failed": 1, "total": 212,
"failures": [{"name": "tests/test_api.py::test_refund", "file": "tests/test_api.py", "message": "AssertionError: 400 != 200"}]}]
}
Recognised output: pytest, go test, Jest, Vitest, cargo test, PHPUnit, JUnit (Maven/Gradle) and mocha. Test results are also part of the job summary and the execution receipt (test_results). Over MCP, get_job_logs returns this digest by default.
Raw log
GET /v1/jobs/{id}/logs?offset=&limit= returns part of the output log; a negative offset reads from the end. It is updated every few seconds while the job runs. In Python: job.logs(offset=0, limit=65536) or job.log_text() for the whole log.
Waiting for results
Instead of asking for the status again and again, wait on the server: POST /v1/jobs/wait returns as soon as one ("until": "any", default) or all ("all") of the given jobs or batches have finished, or after timeout_s (max 60) with "done": false – then call again.
from wbxsandbox import wait_jobs
wait_jobs(["job_…", "job_…"], batch_ids=["bat_…"], until="any", timeout_s=60)
job.wait() # one job, until it ends
curl -s -X POST -H "X-API-Key: $WBXSANDBOX_API_KEY" -H "Content-Type: application/json" \
-d '{"job_ids": ["job_…", "job_…"], "batch_ids": ["bat_…"], "until": "any", "timeout_s": 60}' https://sandbox.wbx.cz/v1/jobs/wait
{"done": true, "finished": 1, "total": 3, "items": [{"id": "job_…", "kind": "job", "status": "completed", "done": true}, …]}
For a notification without waiting at all, use a webhook.