{
  "slug": "github-graphql-api-issue-filters-accept-issue-field-values-8d7bb8b905b0",
  "title": "GitHub GraphQL API issue filters accept issue field values",
  "tools": [
    "github-graphql-api"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-08-12T00:00:00.000Z",
  "announced_at": "2026-08-12T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When maintaining issue triage by project field values, filter the repository’s issues with `IssueFilters.issueFieldValues` and provide exactly one field selector and one value filter per filter object.",
    "examples": [
      "query { repository(owner: \"<owner>\", name: \"<repo>\") { issues(first: 100, filterBy: { issueFieldValues: [{ fieldName: \"<field-name>\", textValue: \"<text>\" }] }) { nodes { id title } } } }"
    ],
    "gotchas": [
      "filterBy: Issue connection filtering options.",
      "issueFieldValues: List issues where each supplied issue field value filter matches.",
      "fieldId: Issue field ID selector; provide exactly one of `fieldId` or `fieldName`.",
      "fieldName: Issue field name selector; provide exactly one of `fieldName` or `fieldId`.",
      "dateValue: Matches a date field value in `YYYY-MM-DD` format.",
      "numberValue: Matches a numeric field value.",
      "textValue: Matches a text field value.",
      "singleSelectOptionId: Matches a single-select option by ID.",
      "singleSelectOptionValue: Matches a single-select option by name.",
      "multiSelectOptionIds: Matches issues containing all listed multi-select option IDs.",
      "multiSelectOptionValues: Matches issues containing all listed multi-select option names.",
      "IssueFieldValueFilter value argument (required): Exactly one of `dateValue`, `numberValue`, `textValue`, `singleSelectOptionId`, `singleSelectOptionValue`, `multiSelectOptionIds`, or `multiSelectOptionValues` should be provided."
    ]
  },
  "why_it_matters": "Filter issues by values in their project fields when maintaining an issue-triage workflow.",
  "sources": [
    "https://docs.github.com/en/graphql/overview/changelog#schema-changes-for-2026-08-12",
    "https://docs.github.com/en/graphql/reference/issues"
  ],
  "rank": 0.90035,
  "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": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-5a3783bc8fadc9b2-0:gate",
    "evidence_hash": "6b63acbc507c1d32586dcb92a4a9f1613fbd958e81c54e0c9e1321728dc5a108"
  },
  "review": {
    "draft_hash": "05a557b23439e72db3d27f46ae0a2033cb57544b00826d1c4b182bcecd859216",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.90 >= 0.9; 2 needed) and Jev gave 0.74 (>= 0.6 needed)."
  }
}