カスタムフィールドの値を消去する
REST API を使用して、課題のカスタムフィールドの値をクリアします。
要約
課題カスタムフィールドの値をクリアするには:
ターゲットの課題のカスタムフィールドに空の値を設定できることを確認してください。
更新発行リクエストを使用:
POST /api/issues/{issueID}?[fields]fieldsリクエストパラメーターで、応答で取得するフィールドを指定します。例: フィールド ID および完全な値の情報。これは、変更が適用されたことを確認できます。リクエストの本文で、必須フィールドに
idまたはname、$typeを指定します。valueのnullを渡します。
ステップバイステップ
オプション。ターゲットの課題フィールドに空の値を設定できるようにするには、
GET要求をサーバーに送信します。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 <YouTrack_token>' \ -H 'Content-Type: application/json' \ -H 'cache-control: no-cache'上記のサンプルリクエストに対して、サーバーは次の本文を含む応答を送信します。
[ { "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" } ]Subsystemissue フィールドの値をクリアするには、次のようにPOSTリクエストを送信します。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 <YouTrack_token>' \ -H 'Content-Type: application/json' \ -H 'cache-control: no-cache' \ -d '{ "customFields": [ {"name":"Subsystem","$type":"SingleOwnedIssueCustomField","value":null} ] }'ターゲット
Subsystemフィールドが現在空の値に設定されていることを確認するために、サーバーからの応答を確認してみましょう。読みやすくするために、レスポンスの本文サンプルには対象の課題フィールドのみを残しています。{ "customFields": [ ..., { "projectCustomField": { "field": { "name": "Subsystem", "$type": "CustomField" }, "$type": "OwnedProjectCustomField" }, "value": null, "id": "92-0", "$type": "SingleOwnedIssueCustomField" }, ... ], "$type": "Issue" }
2026 年 10 月 02 日
