IssueUsage

Represents a link between an external issue tracker issue and the VCS changes that reference it. Returned as part of the relatedIssues collection for a specific build.

Properties

issue

The issue from an external issue tracker that is linked to the VCS changes in this build.

changes

The list of VCS changes (commits) in this build that reference the issue.

Schema

Below, you can find a full schema of this object, in XML and JSON formats. You can choose what fields to submit depending on your current needs. Different methods might expect different fields: the best approach is to request this entity via GET and use the response as a base for the following POST request.

A link to another object implies that you can substitute it with the schema of the linked object, if it is required for your call.

<IssueUsage>
  <issue id="TW-12345" url="https://youtrack.jetbrains.com/issue/TW-12345"/>
  <changes count="3" href="/app/rest/changes" nextHref="/app/rest/changes?locator=count:200,start:250" prevHref="/app/rest/changes?locator=count:50,start:0">
    <change>[[[change...|change.html]]]</change>
  </changes>
</IssueUsage>

{
  "issue" : {
    "id" : "TW-12345",
    "url" : "https://youtrack.jetbrains.com/issue/TW-12345"
  },
  "changes" : {
    "change" : [ {
      "date" : "20240905T151059+0200",
      "vcsRootInstance" : "[[[vcs-root-instance...|vcsrootinstance.html]]]",
      "canEditComment" : true,
      "personal" : true,
      "storesProjectSettings" : false,
      "type" : "VCS_CHANGE",
      "version" : "c1046c4fa016a774253fb3b93e6cc8bd12c159e5, 05 09 2024 17:23",
      "commitDate" : "20240905T151159+0200",
      "snapshotDependencyLink" : "[[[SnapshotDependencyLink...|snapshotdependencylink.html]]]",
      "webUrl" : "https://localhost:8111/change/1417?personal=false",
      "registrationDate" : "20240905T151115+0200",
      "files" : "[[[fileChanges...|filechanges.html]]]",
      "parentRevisions" : "[[[items...|items.html]]]",
      "internalVersion" : "c1046c4fa016a774253fb3b93e6cc8bd12c159e5",
      "comment" : "Update README.md",
      "attributes" : "[[[properties...|properties.html]]]",
      "id" : 1190,
      "href" : "/app/rest/changes/id:704,personal:true",
      "user" : "[[[user...|user.html]]]",
      "commiter" : "[[[commiter...|commiter.html]]]",
      "locator" : "null",
      "parentChanges" : "[[[changes...|changes.html]]]",
      "username" : "username",
      "status" : "[[[ChangeStatus...|changestatus.html]]]"
    } ],
    "count" : 3,
    "prevHref" : "/app/rest/changes?locator=count:50,start:0",
    "href" : "/app/rest/changes",
    "nextHref" : "/app/rest/changes?locator=count:200,start:250"
  }
}

Last modified: 18 August 2026