{
  "slug": "github-graphql-setissuefieldvalue-mutation-adds-issue-field-values-678f12838214",
  "title": "GitHub GraphQL `setIssueFieldValue` mutation adds issue field values",
  "tools": [
    "github-graphql-api"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-12T00:00:00.000Z",
  "announced_at": "2026-03-12T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When setting issue field values, call `Mutation.setIssueFieldValue` with the issue’s node ID and an `issueFields` list. For a text field, include its field ID and `textValue`.",
    "examples": [
      "curl -H \"Authorization: bearer <TOKEN>\" -H \"Content-Type: application/json\" -X POST -d '{\"query\":\"mutation($input: SetIssueFieldValueInput!) { setIssueFieldValue(input: $input) { issueFieldValues { __typename } } }\",\"variables\":{\"input\":{\"issueId\":\"<ISSUE_NODE_ID>\",\"issueFields\":[{\"fieldId\":\"<FIELD_NODE_ID>\",\"textValue\":\"<TEXT>\"}]}}}' https://api.github.com/graphql"
    ],
    "gotchas": [
      "input.issueId (required): Node ID of the issue whose field value to set.",
      "input.issueFields (required): List of issue fields to set; each item uses `IssueFieldCreateOrUpdateInput`.",
      "input.clientMutationId: Unique identifier for the client performing the mutation.",
      "issueFields[].fieldId (required): ID of the issue field.",
      "issueFields[].dateValue: Date value for a date field.",
      "issueFields[].delete: Set to true to delete the field value.",
      "issueFields[].multiSelectOptionIds: IDs of selected options for a multi-select field.",
      "issueFields[].numberValue: Numeric value for a number field.",
      "issueFields[].rationale: Optional rationale for the selected value; maximum 280 characters.",
      "issueFields[].singleSelectOptionId: ID of the selected option for a single-select field.",
      "issueFields[].suggest: If true, store as a pending suggestion for human review instead of applying directly.",
      "issueFields[].textValue: Text value for a text field.",
      "Prerequisite: The token must have the scopes or permissions required for the requested resource; GitHub’s GraphQL guide says requirements depend on the requested data but does not specify a mutation permission for this operation.",
      "Prerequisite: The actor needs triage access or greater to the repository to set and edit issue field values.",
      "`issueId` and `issueFields` are required inputs."
    ]
  },
  "why_it_matters": "Set one or more issue field values through the GitHub GraphQL API.",
  "sources": [
    "https://docs.github.com/en/graphql/overview/changelog#schema-changes-for-2026-03-12",
    "https://docs.github.com/en/graphql/reference/issues",
    "https://docs.github.com/en/graphql/guides/forming-calls-with-graphql",
    "https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields"
  ],
  "rank": 0.92025,
  "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-57d8d410ebef9cd9-11:gate",
    "evidence_hash": "912193d6318cbbe9e6d9a29d83bbd5a8d46afc4c93c8479aad9a6a524b60351c"
  },
  "review": {
    "draft_hash": "4dbdc5588916f1313c5e758db3217d6380cd7c1f90463135dcb821559246eb64",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.92 >= 0.9; 2 needed) and Jev gave 0.69 (>= 0.6 needed)."
  }
}