llms.txt : 機械可読形式のドキュメント索引。このページの Markdown バージョンも利用可能です。

YouTrack 開発者ポータルヘルプ

特定のタグによる操作

このサブリソースを使用すると、特定の課題に追加されたタグを操作できます。

リソース

/api/issues/{issueID}/tags/{tagID}

返されたエンティティ

タグ。エンティティ属性の説明については、「サポートされているフィールド」セクションを参照してください。

サポートされているメソッド

タグ属性

タグを表します。

関連リソース

以下に、このエンティティを操作できるリソースのリストを示します。

WatchFolder を拡張

属性

このテーブルは、Tag エンティティの属性について説明しています。

  • サーバーからの応答で属性を受け取るには、fields 要求パラメーターでその属性を明示的に指定してください。

  • 属性を更新するには、POST リクエストの本文にそれを指定します。

フィールド

タイプ

説明

id

文字列

タグの ID。Read-only

課題

課題の配列

このタグが追加される課題のコレクション。

色

FieldStyle

タグの色設定。

untagOnResolve

Boolean

true の場合、課題が解決されると、このタグは課題から自動的に削除されます。

visibleFor

UserGroup

非推奨。代わりに readSharingSettings 属性を使用してください。

このタグを表示できるユーザーのグループ。タグがその所有者のみに表示される場合、このプロパティは null です。

Can be null .

updateableBy

UserGroup

非推奨。代わりに updateSharingSettings 属性を使用してください。

このタグを更新できるユーザーのグループ。タグの所有者のみがタグを更新できる場合、このプロパティは null です。

Can be null .

readSharingSettings

WatchFolderSharingSettings

このタグを表示できるユーザーとグループ。タグが所有者のみに表示される場合、このプロパティには空の配列が含まれます。Read-only

タグ共有設定

TagSharingSettings

このタグを使用できるユーザーとグループ。これらのユーザーは、表示と更新の権限も持っている課題にタグを追加したり、課題からタグを削除したりできます。タグをその所有者のみが使用できる場合、このプロパティには空の配列が含まれます。Read-only

updateSharingSettings

WatchFolderSharingSettings

このタグを更新できるユーザーとグループ。タグの所有者のみがタグを更新できる場合、このプロパティには空の配列が含まれます。Read-only

オーナー

ユーザー

監視フォルダーを作成したユーザー。Read-only Can be null

名前

文字列

課題フォルダーの名前。

特定のタグを読み取る

課題に追加された特定のタグを読みます。

必須アクセス権

ユーザーは、タグの所有者であるか、タグが共有されているユーザーグループの一部である必要があります。

リクエスト構文

GET /api/issues/{issueID}/tags/{tagID}?{fields}

{tagID}

タグのデータベース ID。

リクエストパラメーター

パラメーター

タイプ

説明

フィールド

文字列

応答で返されるタグ属性のリスト。フィールドが指定されていない場合は、entityID のみが返されます。

サンプル

サンプルリクエスト

https://example.youtrack.cloud/api/issues/NP-12/tags/146-13?fields=name,owner(login,name),visibleFor(name,id)

応答本文のサンプル

{ "owner": { "login": "jane.doe", "name": "Jane Doe", "$type": "User" }, "visibleFor": { "name": "All Users", "id": "23-0", "$type": "UserGroup" }, "name": "Blocked by dependency", "$type": "Tag" }

課題からタグを削除する

課題から特定のタグを削除します。

必須アクセス権

権限が必要です: 読み取りの課題、更新の課題

リクエスト構文

DELETE /api/issues/{issueID}/tags/{tagID}

{tagID}

タグのデータベース ID

リクエストパラメーター

パラメーター

タイプ

説明

フィールド

文字列

応答で返されるタグ属性のリスト。フィールドが指定されていない場合は、entityID のみが返されます。

サンプル

サンプルリクエスト

https://example.youtrack.cloud/api/issues/NP-12/tags/146-25
2026 年 3 月 24 日