Skip to main content
The vlmrun executions command lets you list and retrieve results from agent executions submitted via vlmrun execute or the API.

​
List Executions

# List recent executions (default: last 10)
vlmrun executions list

# Filter by status
vlmrun executions list --status completed
vlmrun executions list --status failed

# Filter by date range
vlmrun executions list --since 2026-03-01 --until 2026-03-30

# Pagination
vlmrun executions list --limit 25 --skip 10

# JSON output
vlmrun executions list -f json
OptionShortDescription
--limitMax items to return (default: 10)
--skipNumber of items to skip (default: 0)
--statusFilter by status: enqueued, pending, running, completed, failed, paused
--sinceShow executions since date (YYYY-MM-DD)
--untilShow executions until date (YYYY-MM-DD)
--format-fOutput format (json)

​
Get Execution

# Get execution details
vlmrun executions get <execution-id>

# Wait for an execution to complete
vlmrun executions get <execution-id> --wait

# Wait with custom timeout
vlmrun executions get <execution-id> --wait --timeout 120

# JSON output
vlmrun executions get <execution-id> -f json
Argument/OptionShortDescription
EXECUTION_IDID of the execution to retrieve (required)
--waitWait for execution to complete (default: --no-wait)
--timeoutTimeout in seconds when waiting (default: 300)
--poll-intervalSeconds between status checks (default: 5)
--format-fOutput format (json)