sincecutoff.com
← all changes

hf jobs scheduled ls adds status, label, and name filters

Introduced 2026-09-03 · score 0.97

HOW TO USE IT

When listing scheduled jobs, filter by status, labels, or name with `hf jobs scheduled ls`; migrate deprecated `-f`/`--filter` expressions to the corresponding flags because they are ignored and warn. In Python, pass label matches to `list_scheduled_jobs(labels=...)`.

hf jobs scheduled ls --status suspended
hf jobs scheduled ls --name <NAME> --label env=prod
from huggingface_hub import list_scheduled_jobs jobs = list_scheduled_jobs(labels={"env": "prod"})

WHY THIS HELPS

List scheduled jobs by status, label, or name in a repository maintenance workflow.

BEFORE THIS CHANGE

The release note's migration table replaces `-f name=daily-report` with `--name daily-report`, `-f env=prod` with `--label env=prod`, `-f suspend!=true` with the default or `--status active`, and `-f suspend=true` with `--status suspended`.

REQUIREMENTS AND LIMITATIONS

  • Version: v1.30.0
  • --status: Filter by `active` or `suspended`; may be comma-separated or repeated. Cannot combine with `--all`.
  • -a, --all: Show all scheduled jobs; default hides suspended jobs. Cannot combine with `--status`.
  • -l, --label TEXT: Filter by a `key=value` label. Repeat to require multiple labels; all filters must match.
  • --name TEXT: Filter by job name; shortcut for `--label name=NAME`.
  • -f, --filter TEXT: Deprecated; use `--status` and `--label`. Release note says this option is accepted but ignored and warns; migrate existing filters.
  • labels: `dict[str, str]` of label key/value pairs; returns scheduled jobs matching all supplied labels.
  • `--status` accepts `active` or `suspended`.
  • `-l`/`--label key=value` is repeatable.
  • `--name` is a shortcut for `--label name=NAME`.
  • `-f`/`--filter` is accepted but ignored and emits a warning; the option will be removed in a future release.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card