Runs
toolplexer runs get
Get the status, output, and cost of a run.
Retrieve a specific run by ID.
Usage
toolplexer runs get -r <run-id> [--wait [timeout]] [-o <file>] [--json]Flags
| Flag | Description |
|---|---|
-r, --run-id <run-id> | Run ID |
-w, --wait [timeout] | Wait for completion; timeout in seconds, default 300 |
-o, --output <file> | Save the complete response without overwriting |
-j, --json | Print raw JSON |
Status
READY and RUNNING are active states. Terminal states are COMPLETED,
FAILED, BLOCKED, STOPPED, and TIMED_OUT. A completed run can still carry
providerHttpStatus and errorSource, which distinguish a provider response
from a ToolPlexer infrastructure failure.
Examples
toolplexer runs get -r <run-id>
toolplexer runs get -r <run-id> --wait -o results.json
toolplexer runs get -r <run-id> --wait 60
ToolPlexer