Skip to main content

GET /api/agent/{zid}/sandbox/runs

Returns the most recent runs for the agent, newest first.

Bodies are included (capped server-side at 64 KB per stream); for very long listings the UI can pass limit=5 and request more lazily.

MethodGET
Path/api/agent/{zid}/sandbox/runs
Feature areaAgent
TagAccounts & Keys
Authmachine key — Authorization: Bearer $ZEQ_KEY
Tierauthenticated (machine-control)

Parameters​

Path parameters​

NameTypeRequiredDescription
zidstringyes—

Query parameters​

NameTypeRequiredDescription
limitstringno—

No header parameters are published for this operation.

Request body​

This operation takes no request body.

Responses​

StatusMeaning
200OK
401Missing or invalid credentials
500Server error

401 body​

FieldTypeRequiredDescription
okboolean — one of falseyes—
errorstringnoHuman-readable message.
codestringnoStable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED.

500 body​

FieldTypeRequiredDescription
okboolean — one of falseyes—
errorstringnoHuman-readable message.
codestringnoStable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED.

Call it​

curl -sS -X GET https://zeq.me/api/agent/ZEQ7B3K9QX2M7T4V8N1C6H0DZ/sandbox/runs?limit=example \
-H "Authorization: Bearer $ZEQ_KEY"

Needs a machine key. Mint one: curl -sS -X POST https://zeq.me/api/demo-key/mint, then spin up your machine.


Generated from the live OpenAPI description (https://zeq.me/openapi.json, spec version 1.287.0) by scripts/generate-reference.mjs. Do not edit — this file is rewritten on every run.