v2

latestOpenAPI 3.0.3MIT2026-07-26644258.0 KB
Agent Sandbox

Create or update a chain definition

Steps reference scenario names (see /agent/v1/scenarios) plus 'ok' for a normal response. loop=true wraps past the end; loop=false holds the final step forever. scope 'per-run' keys position by X-Agent-Run-Id (falls back to per-key without one); 'per-key' shares position across all calls on the key.

post/agent/v1/chains

Request body

namestring required
stepsstring[] required
loopboolean
scope'per-run' | 'per-key'

Example request

{
  "steps": [
    "ok",
    "ok",
    "rate-limited",
    "timeout",
    "ok"
  ]
}

Response

Definition stored