Skip to content

monid runs

List and inspect runs.

Commands


runs list

List recent runs with cursor-based pagination.

Usage

bash
monid runs list [--limit <limit>] [--cursor <cursor>] [--json]

Flags

FlagTypeRequiredDescription
--limit <limit>numberNoMaximum number of runs to return
--cursor <cursor>stringNoPagination cursor from a previous response
-j, --jsonbooleanNoOutput 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

FlagTypeRequiredDescription
-r, --run-id <runId>stringYesThe run ID to look up
-w, --wait [timeout]numberNoWait for completion. Optional timeout in seconds (default: 300)
-o, --output <path>stringNoSave output to a file
-j, --jsonbooleanNoOutput 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 60

Run Statuses

StatusMeaning
READYQueued, waiting to start
RUNNINGActively executing
COMPLETEDFinished successfully, results available
FAILEDExecution failed -- check error details

Next Steps

The data layer for AI agents.