monid runs
List and inspect runs.
Commands
monid runs list-- List recent runsmonid runs get-- Get a specific run's status and results
runs list
List recent runs with cursor-based pagination.
Usage
bash
monid runs list [--limit <limit>] [--cursor <cursor>] [--json]Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--limit <limit> | number | No | Maximum number of runs to return |
--cursor <cursor> | string | No | Pagination cursor from a previous response |
-j, --json | boolean | No | Output raw JSON |
Examples
bash
# List recent runs
monid runs list
# List with a limit
monid runs list --limit 5
# Paginate
monid runs list --cursor <cursor-value>runs get
Get the status and results of a specific run.
Usage
bash
monid runs get -r <run-id> [--wait [timeout]] [-o <file>] [--json]Flags
| Flag | Type | Required | Description |
|---|---|---|---|
-r, --run-id <runId> | string | Yes | The run ID to look up |
-w, --wait [timeout] | number | No | Wait for completion. Optional timeout in seconds (default: 300) |
-o, --output <path> | string | No | Save output to a file |
-j, --json | boolean | No | Output raw JSON |
Examples
bash
# Check current status
monid runs get -r 01HXYZ...
# Wait for completion and save results
monid runs get -r 01HXYZ... --wait -o results.json
# Wait with custom timeout
monid runs get -r 01HXYZ... --wait 60Run Statuses
| Status | Meaning |
|---|---|
READY | Queued, waiting to start |
RUNNING | Actively executing |
COMPLETED | Finished successfully, results available |
FAILED | Execution failed -- check error details |
Next Steps
monid run-- Start a new runmonid discover-- Find endpoints to run