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 suspendedhf jobs scheduled ls --name <NAME> --label env=prodfrom 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
- https://github.com/huggingface/huggingface_hub/releases/tag/v1.30.0
- https://huggingface.co/docs/huggingface_hub/v1.30.0/en/package_reference/cli
- https://huggingface.co/docs/huggingface_hub/v1.30.0/en/guides/jobs
- https://huggingface.co/docs/huggingface_hub/v1.30.0/en/package_reference/hf_api
Check the installed version and the source before using it. Entry JSON