tofupilot phases

Last updated on June 16, 2026

The phases command queries Phases, the individual steps inside runs.

ls

The ls subcommand lists and filters phases, scoped to a single procedure via --procedure-id. The full filter list is: --procedure-id, --names, --outcomes, --started-after, --started-before, --exclude-retries, --run-outcomes, --ids, --duration-min, --duration-max, --deployment-ids, --procedure-versions, --environments, --operated-by-ids, --created-by-station-ids, --created-by-user-ids, --serial-numbers, --part-numbers, --revision-numbers, --batch-numbers, --samples, --sort-by, --sort-order, --limit, and --cursor.

filter phases
tofupilot phases ls --procedure-id proc_abc --outcomes FAIL --exclude-retries true

get

The get subcommand fetches a single phase by ID.

get phase
tofupilot phases get --id phase_abc123

How is this guide?

On this page