Update field configuration items

PUT

/rest/api/3/fieldconfiguration/{id}/fields

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).

Permissions required: Administer Jira global permission.

Request

Path Params

Body Params application/json

Examples

Responses

🟢204No Content

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/rest/api/3/fieldconfiguration//fields' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fieldConfigurationItems": [
        {
            "description": "The new description of this item.",
            "id": "customfield_10012",
            "isHidden": false
        },
        {
            "id": "customfield_10011",
            "isRequired": true
        },
        {
            "description": "Another new description.",
            "id": "customfield_10010",
            "isHidden": false,
            "isRequired": false,
            "renderer": "wiki-renderer"
        }
    ]
}'

Response Example

null

Modified at 2025-07-16 07:18:01

Get field configuration items

Get all field configuration schemes