Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.2501.ai/llms.txt

Use this file to discover all available pages before exploring further.

Delete scenario run data from the database. Always shows a preview and asks for confirmation before proceeding. 
2501-runner flush [filters] [options]
At least one filter is required.

​
Options

OptionDescription
--older-than <duration>Delete records older than the given duration. Accepts 7d, 24h, 2w, 1m, etc.
--scenario <keys>Filter by scenario key(s), comma-separated (e.g. nginx/001-broken-config,disk).
--status <status>Filter by status (see below).
--deprecatedDelete records for scenario keys that no longer exist on disk.
--allDelete all scenario run data. Requires typing yes to confirm.
--previewShow what would be deleted without deleting anything.
-y, --yesSkip the confirmation prompt.
-p, --scenarios-path <path>Path to scenarios directory (used with --deprecated, auto-detected if omitted).
--env-file <path>Path to env file (auto-detected if omitted).
--status values:
ValueNamespace
PASSED / FAILEDScenarioReport status
success / agentic_failure / hard_failure / no_tasks_createdJob resolution status

​
Examples

# Preview what would be deleted for scenarios older than 7 days
2501-runner flush --older-than 7d --preview

# Delete all runs for a specific scenario
2501-runner flush --scenario nginx/001-broken-config

# Delete all failed runs older than 30 days
2501-runner flush --older-than 30d --status FAILED

# Delete records for scenarios that no longer exist on disk
2501-runner flush --deprecated

# Delete everything (requires typing "yes")
2501-runner flush --all

# Non-interactive delete (CI usage)
2501-runner flush --older-than 14d --yes
Each flush removes matched ScenarioReport records along with their associated Job, Task, and Ticket records. The preview box shows exact counts before deletion. Run history is also visible in the Benchmark page in Command Center.