---
schema: rendered-html/v1
title: "Update a Text Field Value | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-usecase-update-text-field-value.html
generated_at: 2026-06-11T15:01:23.440653+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
- REST API Reference
- REST API Use Cases
- Create an Issue
- Create an Issue and Set Custom Fields
- Get Issues List with All Values
- Get Value for an Issue Custom Field
- [Add Value to a Set](jetbrains__com__help__youtrack__devportal__api-usecase-add-value-to-bundle.md)
- Update Issue Custom Fields
- [Update a Text Field Value](api-usecase-update-text-field-value.html)
- Clear Values of Custom Fields
- [Apply Commands to Issues](jetbrains__com__help__youtrack__devportal__api-usecase-commands.md)
- Tag or Untag Issues
- [Work with Issue Tags](jetbrains__com__help__youtrack__devportal__api-usecase-work-with-tags.md)
- [Attach Files to an Issue](jetbrains__com__help__youtrack__devportal__api-usecase-attach-files.md)
- [Delete an Issue Attachment](jetbrains__com__help__youtrack__devportal__api-usecase-delete-issue-attachment.md)
- [Download an Issue Attachment](jetbrains__com__help__youtrack__devportal__api-usecase-download-issue-attachment.md)
- Link Issues
- [Get Issue History](jetbrains__com__help__youtrack__devportal__api-usecase-issue-history.md)
- [Get a Database Backup](jetbrains__com__help__youtrack__devportal__api-usecase-backup.md)
- 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 a Text Field Value](#0)

# Update a Text Field Value﻿

Last modified: 07 May 2026

## Use Case﻿

Use the REST API to update the value stored in a custom field with `text` type.

## Summary﻿

Make a POST request to the following endpoint: `/api/issues/{issueID}?[fields]`

## Step-by-Step﻿

1. To update a custom text field in an issue, send a POST request to the target issue. You can reference the issue by issue ID or issue entity ID.
2. In the `fields` request parameter, specify the attributes of the returned entity that you want to get in response. For example, you can request the `id` and `name` of the target custom field along with its updated value.
3. In the request body, pass a JSON with the `name`, `$type`, and `value` for the text field that you want to update.

   So, the final request is:

   ```
   curl -X POST 'https://example.youtrack.cloud/api/issues/NP-98?fields=customFields(id,name,value(text))' \
   -H 'Accept: application/json' \
   -H 'Authorization: Bearer perm:cm9vdA==.MjZGZWI=.WB02vjX0cM2ltLTJXUE3VOWHpJYYNx' \
   -H 'Content-Type: application/json' \
   -d '{"customFields":[{"name":"Customer","$type":"TextIssueCustomField","value":{"text":"Valued Customer"}}]}'
   ```
4. To confirm that the target issue text field was set to the corresponding value, let's check the response from the server:

   ```
   {
       "customFields": [
           ...
           {
               "value": {
                   "text": "Valued Customer",
                   "$type": "TextFieldValue"
               },
               "name": "Customer",
               "id": "194-4",
               "$type": "TextIssueCustomField"
           }
       ],
       "$type": "Issue"
   }
   ```

- [Update a Text Field Value](/help/youtrack/devportal/api-usecase-update-text-field-value.html)
- [Use Case](/help/youtrack/devportal/api-usecase-update-text-field-value.html#use-case)
- [Summary](/help/youtrack/devportal/api-usecase-update-text-field-value.html#summary)
- [Step-by-Step](/help/youtrack/devportal/api-usecase-update-text-field-value.html#step-by-step)

Update Issue Custom FieldsClear Values of Custom Fields

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

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

![](https://bat.bing.com/action/0?ti=5220035&tm=gtm002&Ver=2&mid=d589f3ea-eb5d-442b-a171-bcee1e5348ff&bo=4&sid=452929b065a111f19a7fe7356f74a419&vid=aa3122f0648711f1a10d6d095e10fd87&vids=0&msclkid=N&pi=918639831&lg=en-US&sw=1920&sh=1080&sc=24&tl=Update%20a%20Text%20Field%20Value%20%7C%20Developer%20Portal%20for%20YouTrack%20and%20Hub%20Documentation&p=https%3A%2F%2Fwww.jetbrains.com%2Fhelp%2Fyoutrack%2Fdevportal%2Fapi-usecase-update-text-field-value.html&r=&lt=498&pt=1781190081162,56,56,,,2,2,2,2,2,,2,32,32,59,193,193,193,498,498,498&pn=0,0&evt=pageLoad&sv=2&asc=G&cdb=AQAS&rn=855986)

![](https://crawler.prototype.prolicht.digital/l/kTQdM4)![](https://crawler.prototype.prolicht.digital/l/Lwdw9a)
