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

FlagDescription
-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, --jsonPrint 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

On this page