Start a swarm
/bin/sh -c in /root. For code tasks, select a prepared template or snapshot, or clone a public repository inside the command.
The API is POST /swarms. Supply an idempotency key and exactly one of count or inputs:
BEAD_SWARM_INPUT, its zero-based index in BEAD_SWARM_INDEX, and zero-based attempt in BEAD_SWARM_ATTEMPT. A count supplies JSON null inputs.
Poll and collect
queued, running, completed, failed, or cancelled. Results are available after terminal state; the results route returns 409 while running. Check every member’s exit code and error details. A null exit code means no confirmed command exit.
Results expire 24 hours after completion. Each stdout/stderr stream retains at most 64 KiB and includes encoding and truncation information. Optional output_files globs collect at most 16 files and 32 KiB total. Files use base64 bytes; collection errors do not replace the command exit code.
Bounds and retries
There are at most 256 total possible attempts, with 0–3 retries, concurrency 1–256, and a 1–3600-second member limit. Commands and each serialized input are limited to 16 KiB. All possible attempts are admitted and funded up front. Waiting for capacity consumes the job deadline. Retries can repeat external effects. An uncertain command is not silently replayed; a fresh attempt is possible only when you allowed retries.Cancel
swarm.completed through webhooks for a terminal notification and results URL.