---
title: "Set issue field values for an issue"
method: PUT
path: "/repos/{owner}/{repo}/issues/{issue_number}/issue-field-values"
tags: ["issues"]
---

# Set issue field values for an issue

`PUT /repos/{owner}/{repo}/issues/{issue_number}/issue-field-values`

Set custom field values for an issue, replacing any existing values. You can set values for organization-level issue fields that have been defined for the repository's organization.

This endpoint supports the following field data types:
- **`text`**: String values for text fields
- **`single_select`**: Option names for single-select fields (must match an existing option name)
- **`number`**: Numeric values for number fields
- **`date`**: ISO 8601 date strings for date fields

This operation will replace all existing field values with the provided ones. If you want to add field values without replacing existing ones, use the `POST` endpoint instead.

Only users with push access to the repository can set issue field values. If you don't have the proper permissions, you'll receive a `403 Forbidden` response.

This endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)"
and "[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest/rest/guides/best-practices-for-using-the-rest-api)."

## Path parameters

- `owner` string, required
- `repo` string, required
- `issue_number` integer, required

## Request body

- object
  - `issue_field_values` object[] — An array of issue field values to set for this issue. Each field value must include the field ID and the value to set. All existing field values will be replaced.
    - `field_id` integer, required — The ID of the issue field to set
    - `value` union, required — The value to set for the field. The type depends on the field's data type: - For text fields: provide a string value - For single_select fields: provide the option name as a string (must match an existing option) - For number fields: provide a numeric value - For date fields: provide an ISO 8601 date string
      - string — The value to set for text, single_select, or date fields
      - number — The value to set for number fields

## Response `200`

Response

- IssueFieldValue[] — The current issue field values for this issue after setting the new values
  - `issue_field_id` integer, required — Unique identifier for the issue field.
  - `issue_field_name` string — The human-readable name of the issue field.
  - `node_id` string, required
  - `data_type` 'text' | 'single_select' | 'multi_select' | 'number' | 'date', required — The data type of the issue field
  - `value` union, required — The value of the issue field
    - string
    - number
    - integer
  - `single_select_option` object, nullable — Details about the selected option (only present for single_select fields)
    - `id` integer, required — Unique identifier for the option.
    - `name` string, required — The name of the option
    - `color` string, required — The color of the option
  - `multi_select_options` object[], nullable — Details about the selected options
    - `id` integer, required — Unique identifier for the option.
    - `name` string, required — The name of the option
    - `color` string, required — The color of the option

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Resource not found
- `422` — Validation failed, or the endpoint has been spammed.
- `503` — Service unavailable

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)