---
schema: rendered-html/v1
title: "Update Issue Custom Fields | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-how-to-update-custom-fields-values.html
generated_at: 2026-06-11T14:59:48.326990+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- YouTrack REST API
- [Get Started with REST API](jetbrains__com__help__youtrack__devportal__api-getting-started.md)
- REST API Reference
- REST API Use Cases
- [Create an Issue](jetbrains__com__help__youtrack__devportal__api-howto-create-issue.md)
- [Create an Issue and Set Custom Fields](jetbrains__com__help__youtrack__devportal__api-howto-create-issue-with-fields.md)
- [Get Issues List with All Values](jetbrains__com__help__youtrack__devportal__api-howto-get-issues-with-all-values.md)
- [Get Value for an Issue Custom Field](jetbrains__com__help__youtrack__devportal__api-howto-get-value-for-specific-cf.md)
- Add Value to a Set
- [Update Issue Custom Fields](api-how-to-update-custom-fields-values.html)
- Update a Text Field Value
- [Clear Values of Custom Fields](jetbrains__com__help__youtrack__devportal__api-how-to-clear-custom-fields-values.md)
- Apply Commands to Issues
- Tag or Untag Issues
- Work with Issue Tags
- Attach Files to an Issue
- Delete an Issue Attachment
- Download an Issue Attachment
- [Link Issues](jetbrains__com__help__youtrack__devportal__api-howto-link-issues.md)
- Get Issue History
- Get a Database Backup
- Add User to Project Team
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. REST API Use Cases
3. [Update Issue Custom Fields](#0)

# Update Issue Custom Fields﻿

Last modified: 07 May 2026

## Use Case﻿

Use the REST API to update values of issue custom fields.

## Summary﻿

To update a value of an issue custom field:

1. Use Update Issue request:

   ```
   POST /api/issues/{issueID}?[fields]
   ```
2. In the `fields` request parameter specify fields you want to get in response. For example, field id and full value info. This will help you to confirm that your changes are applied.
3. In the request body specify the `id` or `name`, `$type` and value json for each issue custom field that you need to update.

## Step-by-Step﻿

1. To update issue custom fields, send a `POST` request to the target issue. You can use either issue id or issues's entity id to reference issue.

   ```
   POST /api/issues/{issueID}?[fields]
   ```
2. In the `fields` request parameter specify the attributes of the returned entity that you want to get in response. For example, `id`, `name` of an issue custom field and all attributes of its `value`. This will help to verify that your changes were applied.
3. In the request body specify the `id` or `name`, `$type` and value json for each issue custom field that you need to update.

   To form value json you need to get id of the value (bundleElement) you want to post. For that:

   - Get corresponding Project Custom Field:

     ```
     GET /api/admin/projects/{projectID}/customFields/{fieldID}
     ```
   - Get `bundle` from supported attributes for Project Custom Field:

     ```
     GET /api/admin/projects/{projectID}/customFields/{fieldID}?fields=bundle(values(id,name,$type),aggregatedUsers(id,name,$type))
     ```

   So, the final request is:

   ```
   curl -X POST \
   'https://example.youtrack.cloud/api/issues/SP-8?fields=customFields(id,name,value(avatarUrl,buildLink,color(id),fullName,id,isResolved,localizedName,login,minutes,name,presentation,text))' \
   -H 'Accept: application/json' \
   -H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' \
   -H 'Content-Type: application/json' \
   -d '{
   "customFields": [
   {"name":"Assignee","$type":"SingleUserIssueCustomField","value":{"login":"jane.doe"}},
   {"name":"Priority","$type":"SingleEnumIssueCustomField","value":{"name":"Major"}},
   {"name":"Fix versions","$type":"MultiVersionIssueCustomField","value":[{"name":"2019.1"}]},
   {"name":"Requester email","$type":"SimpleIssueCustomField","value":"test@example.com"},
   ] }'
   ```
4. To confirm that the target issue custom fields currently are set to corresponding values, let's check the response from the server:

   ```
   {
       "customFields":[
           {
               "id":"92-1",
               "name":"Priority",
               "value":{
                   "localizedName":null,
                   "color":{
                       "id":"18"
                   },
                   "name":"Major",
                   "id":"67-2"
               }
           },
           ...
           {
               "id":"94-0",
               "name":"Assignee",
               "value":{
                   "login":"jane.doe",
                   "avatarUrl": "/hub/api/rest/avatar/90704ebe-c211-4906-a328-4f16ca82a5ea?s=48",
                   "fullName":"Jane Doe",
                   "name":"Jane Doe",
                   "id":"1-3"
               }
           },
           ...
           {
               "id":"92-4",
               "name":"Fix versions",
               "value":[
                   {
                       "id":"133-19",
                       "name":"2019.1",
                       "color":{
                           "id":"3"
                       }
                   }
               ]
           }
           ...
           {
               "id":"92-6",
               "name":"Requester email",
               "value":"test@example.com"
           }
           ...
       ]
   }
   ```

- [Update Issue Custom Fields](/help/youtrack/devportal/api-how-to-update-custom-fields-values.html)
- [Use Case](/help/youtrack/devportal/api-how-to-update-custom-fields-values.html#use-case)
- [Summary](/help/youtrack/devportal/api-how-to-update-custom-fields-values.html#summary)
- [Step-by-Step](/help/youtrack/devportal/api-how-to-update-custom-fields-values.html#step-by-step)

Add Value to a SetUpdate a Text Field Value

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.
