Update custom field value

PUT

/rest/api/3/app/field/{fieldIdOrKey}/value

Updates the value of a custom field on one or more issues.

Apps can only perform this operation on custom fields and custom field types declared in their own manifests.

Permissions required: Only the app that owns the custom field or custom field type can update its values with this operation.

The new write:app-data:jira OAuth scope is 100% optional now, and not using it won't break your app. However, we recommend adding it to your app's scope list because we will eventually make it mandatory.

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢204No Content

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/rest/api/3/app/field//value' \
--header 'Content-Type: application/json' \
--data-raw '{
    "updates": [
        {
            "issueIds": [
                10010
            ],
            "value": "new value"
        }
    ]
}'

Response Example

null

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

Update custom fields

Get application property