---
title: "Update field configuration items"
method: PUT
path: "/rest/api/2/fieldconfiguration/{id}/fields"
tags: ["Issue field configurations"]
deprecated: true
---

# Update field configuration items

`PUT /rest/api/2/fieldconfiguration/{id}/fields`

> **Deprecated.**

Deprecated, use [ Field schemes](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-field-schemes/#api-group-field-schemes) which supports field association schemes.

Updates fields in a field configuration. The properties of the field configuration fields provided override the existing values.

This operation can only update field configurations used in company-managed (classic) projects.

The operation can set the renderer for text fields to the default text renderer (`text-renderer`) or wiki style renderer (`wiki-renderer`). However, the renderer cannot be updated for fields using the autocomplete renderer (`autocomplete-renderer`).

Hiding a field deletes it from the field configuration - deleting the required, description and renderer type values as well. As a result, hiding and unhiding will not restore the other values but use their default values.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `id` integer, required

## Request body

- FieldConfigurationItemsDetails — Details of field configuration items.
  - `fieldConfigurationItems` FieldConfigurationItem[], required — Details of fields in a field configuration.
    - `description` string — The description of the field within the field configuration.
    - `id` string, required — The ID of the field within the field configuration.
    - `isHidden` boolean — Whether the field is hidden in the field configuration.
    - `isRequired` boolean — Whether the field is required in the field configuration.
    - `renderer` string — The renderer type for the field within the field configuration.

## Response `204`

Returned if the request is successful.

- unknown

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.
- `404` — Returned if the field configuration is not found.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)