カスタムフィールドのデフォルト値を設定する

プロジェクトのカスタムフィールドにデフォルト値を設定するには

1. デフォルト値を設定するプロジェクトの ID を取得します。手順については、プロジェクト ID を取得するを参照してください。この例では、エンティティ ID が 0-0 のプロジェクト Sample Project を使用しています。

2. プロジェクトに紐付けられているカスタムフィールドの一覧を取得します。フィールド ID、フィールド名、割り当てられているバンドル、現在のデフォルト値を要求します。

   curl -X GET 'https://example.youtrack.cloud/api/admin/projects/0-0/customFields?fields=id,field(name),bundle(id,name,values(id,name)),defaultValues(id,name),$type' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json'

   レスポンス内で、デフォルトとして設定したいカスタムフィールドと値を探します。この例では、エンティティ ID が 105-42 の Affected versions フィールドと、エンティティ ID が 133-19 の 2026.1 バージョン値を使用しています。

   [ { "field": { "name": "Affected versions", "$type": "CustomField" }, "bundle": { "values": [ { "name": "2026.1", "id": "133-19", "$type": "VersionBundleElement" }, { "name": "2026.2", "id": "133-24", "$type": "VersionBundleElement" } ], "name": "Affected versions", "id": "97-4", "$type": "VersionBundle" }, "defaultValues": [], "id": "105-42", "$type": "VersionProjectCustomField" } ]

3. プロジェクトのカスタムフィールドの defaultValues 属性を更新して、デフォルト値を設定します。

   curl -X POST 'https://example.youtrack.cloud/api/admin/projects/0-0/customFields/105-42?fields=id,field(name),defaultValues(id,name)' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json' \ -d '{ "defaultValues": [ {"id": "133-19", "$type": "VersionBundleElement"} ] }'

   リクエストが成功した場合、レスポンスには更新されたプロジェクトカスタムフィールドが含まれます。

   { "field": { "name": "Affected versions", "$type": "CustomField" }, "defaultValues": [ { "name": "2026.1", "id": "133-19", "$type": "VersionBundleElement" } ], "id": "105-42", "$type": "VersionProjectCustomField" }