Update custom field configurations

PUT

/rest/api/3/app/field/{fieldIdOrKey}/context/configuration

Update the configuration for contexts of a custom field of a type created by a Forge app.

Permissions required: Administer Jira global permission. Jira permissions are not required for the Forge app that created the custom field type.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200OK

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/app/field//context/configuration' \
--header 'Content-Type: application/json' \
--data-raw '{
    "configurations": [
        {
            "id": "10000"
        },
        {
            "configuration": {
                "maxValue": 10000,
                "minValue": 0
            },
            "id": "10001",
            "schema": {
                "properties": {
                    "amount": {
                        "type": "number"
                    },
                    "currency": {
                        "type": "string"
                    }
                },
                "required": [
                    "amount",
                    "currency"
                ]
            }
        }
    ]
}'

Response Example

null

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

Get custom field configurations

Update custom fields