---
schema: rendered-html/v1
title: "Clear Values of Custom Fields | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/api-how-to-clear-custom-fields-values.html
generated_at: 2026-06-11T14:59:48.571782+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](jetbrains__com__help__youtrack__devportal__api-how-to-update-custom-fields-values.md)
- Update a Text Field Value
- [Clear Values of Custom Fields](api-how-to-clear-custom-fields-values.html)
- 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. [Clear Values of Custom Fields](#0)

# Clear Values of Custom Fields﻿

Last modified: 07 May 2026

## Use Case﻿

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

## Summary﻿

To clear a value of an issue custom field:

1. Make sure that the target issue custom field can have an empty value.
2. Use Update Issue request:

   ```
   POST /api/issues/{issueID}?[fields]
   ```
3. 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.
4. In the request body specify the `id` or `name`, and `$type` for required field. Pass `null` for `value`.

## Step-by-Step﻿

1. Optional. To be sure that the target issue field can have an empty value, send a `GET` request to the server:

   ```
   curl -X GET \
   'https://example.youtrack.cloud/api/issues/2-7/customFields?fields=id,projectCustomField(canBeEmpty,field(name))' \
   -H 'Accept: application/json' \
   -H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' \
   -H 'Content-Type: application/json' \
   -H 'cache-control: no-cache'
   ```

   To the sample request above, the server sends a response with the following body:

   ```
   [
       {
           "projectCustomField": {
               "canBeEmpty": false,
               "field": {
                   "name": "Priority",
                   "$type": "CustomField"
               },
               "$type": "EnumProjectCustomField"
           },
           "id": "92-1",
           "$type": "SingleEnumIssueCustomField"
       },
       {
           "projectCustomField": {
               "canBeEmpty": false,
               "field": {
                   "name": "Type",
                   "$type": "CustomField"
               },
               "$type": "EnumProjectCustomField"
           },
           "id": "92-2",
           "$type": "SingleEnumIssueCustomField"
       },
       {
           "projectCustomField": {
               "canBeEmpty": false,
               "field": {
                   "name": "State",
                   "$type": "CustomField"
               },
               "$type": "StateProjectCustomField"
           },
           "id": "92-3",
           "$type": "StateIssueCustomField"
       },
       {
           "projectCustomField": {
               "canBeEmpty": true,
               "field": {
                   "name": "Assignee",
                   "$type": "CustomField"
               },
               "$type": "UserProjectCustomField"
           },
           "id": "94-0",
           "$type": "SingleUserIssueCustomField"
       },
       {
           "projectCustomField": {
               "canBeEmpty": true,
               "field": {
                   "name": "Subsystem",
                   "$type": "CustomField"
               },
               "$type": "OwnedProjectCustomField"
           },
           "id": "92-0",
           "$type": "SingleOwnedIssueCustomField"
       },
       {
           "projectCustomField": {
               "canBeEmpty": true,
               "field": {
                   "name": "Fix versions",
                   "$type": "CustomField"
               },
               "$type": "VersionProjectCustomField"
           },
           "id": "92-4",
           "$type": "MultiVersionIssueCustomField"
       },
       {
           "projectCustomField": {
               "canBeEmpty": true,
               "field": {
                   "name": "Affected versions",
                   "$type": "CustomField"
               },
               "$type": "VersionProjectCustomField"
           },
           "id": "92-5",
           "$type": "MultiVersionIssueCustomField"
       },
       {
           "projectCustomField": {
               "canBeEmpty": true,
               "field": {
                   "name": "Fixed in build",
                   "$type": "CustomField"
               },
               "$type": "BuildProjectCustomField"
           },
           "id": "92-6",
           "$type": "SingleBuildIssueCustomField"
       }
   ]
   ```
2. To clear the value of the `Subsystem` issue field, send a `POST` request as follows:

   ```
   curl -X POST \
   'https://example.youtrack.cloud/api/issues/2-7?fields=customFields(id,projectCustomField(field(name)),value(avatarUrl,buildLink,fullName,id,isResolved,login,minutes,name,presentation,text))' \
   -H 'Accept: application/json' \
   -H 'Authorization: Bearer perm:am9obi5kb2U=.UG9zdG1hbiBKb2huIERvZQ==.jJe0eYhhkV271j1lCpfknNYOEakNk7' \
   -H 'Content-Type: application/json' \
   -H 'cache-control: no-cache' \
   -d '{ "customFields": [ {"name":"Subsystem","$type":"SingleOwnedIssueCustomField","value":null} ] }'
   ```
3. To confirm that the target `Subsystem` field currently is set to an empty value, let's check the response from the server. For readability, we left only the target issue field in the response body sample:

   ```
   {
       "customFields": [
           ...,
           {
               "projectCustomField": {
                   "field": {
                       "name": "Subsystem",
                       "$type": "CustomField"
                   },
                   "$type": "OwnedProjectCustomField"
               },
               "value": null,
               "id": "92-0",
               "$type": "SingleOwnedIssueCustomField"
           },
           ...
       ],
       "$type": "Issue"
   }
   ```

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

Update a Text Field ValueApply Commands to Issues

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

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