{
  "slug": "hf-jobs-scheduled-ls-adds-status-label-and-name-filters-8f325f0b9f9d",
  "title": "hf jobs scheduled ls adds status, label, and name filters",
  "tools": [
    "hf"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-03T09:42:41.000Z",
  "announced_at": "2026-09-03T09:42:41.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "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=...)`.",
    "examples": [
      "hf jobs scheduled ls --status suspended",
      "hf jobs scheduled ls --name <NAME> --label env=prod",
      "from huggingface_hub import list_scheduled_jobs\njobs = list_scheduled_jobs(labels={\"env\": \"prod\"})"
    ],
    "gotchas": [
      "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."
    ]
  },
  "why_it_matters": "List scheduled jobs by status, label, or name in a repository maintenance workflow.",
  "before": "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`.",
  "sources": [
    "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"
  ],
  "rank": 0.97025,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2b-20261017",
    "verdict_id": "wave2b-20261017:wave2b-20261017-2b8e935bd4e7619c-0:gate",
    "evidence_hash": "b7b5b9a7d269d5f40476b18c14700eff4328390a99ba764f472e51cb3d7b6493"
  },
  "review": {
    "draft_hash": "b596f624bc08e40dd4199dfd305ab15210384a1e763f1f722849110ee1f8f53a",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2b-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.76 (>= 0.6 needed)."
  }
}