Operations with Specific IssueTimeTracking
This sub-resource lets you read work items of an issue and time tracking status in the issue's project.
Resource |
|
Returned entity | IssueTimeTracking. For the description of the entity attributes, see Supported Fields section. |
Supported methods |
IssueTimeTracking attributes
Represents time tracking settings in the issue.
This table describes attributes of the IssueTimeTracking
entity.
To receive an attribute in the response from server, specify it explicitly in the request parameter
fields
.To update an attribute, provide it in the body of a POST request.
Field | Type | Description |
---|---|---|
workItems | Array of IssueWorkItems | Collection of work items of the issue. |
enabled | Boolean | Indicates whether the time tracking is enabled in the project that the issue belongs to. |
Read a Specific IssueTimeTracking
Get work items of an issue and time tracking status.
Request syntax
GET /api/issues/{issueID}/timeTracking?{fields}
Request parameters
Parameter | Type | Description |
---|---|---|
fields | String | A list of IssueTimeTracking attributes that should be returned in the response. If no field is specified,only the |
Sample
Sample request URI
https://example.myjetbrains.com/youtrack/api/issues/SNBX-1/timeTracking?fields=draftWorkItem(id),enabled,workItems(created,duration(presentation,minutes),author(name),creator(name),date,id)
Sample response body
{
"enabled": true,
"workItems": [
{
"duration": {
"presentation": "5h",
"minutes": 300,
"$type": "DurationValue"
},
"created": 1536278263415,
"date": 1536278400000,
"creator": {
"name": "John Smith",
"$type": "User"
},
"author": {
"name": "John Smith",
"$type": "User"
},
"id": "115-0",
"$type": "IssueWorkItem"
},
{
"duration": {
"presentation": "1h",
"minutes": 60,
"$type": "DurationValue"
},
"created": 1539088817836,
"date": 1538956800000,
"creator": {
"name": "John Doe",
"$type": "User"
},
"author": {
"name": "Jane Doe",
"$type": "User"
},
"id": "115-2",
"$type": "IssueWorkItem"
},
{
"duration": {
"presentation": "2h",
"minutes": 120,
"$type": "DurationValue"
},
"created": 1539089914788,
"date": 1538956800000,
"creator": {
"name": "John Doe",
"$type": "User"
},
"author": {
"name": "John Doe",
"$type": "User"
},
"id": "115-5",
"$type": "IssueWorkItem"
},
{
"duration": {
"presentation": "2h",
"minutes": 120,
"$type": "DurationValue"
},
"created": 1539089922573,
"date": 1538956800000,
"creator": {
"name": "John Doe",
"$type": "User"
},
"author": {
"name": "Jane Doe",
"$type": "User"
},
"id": "115-6",
"$type": "IssueWorkItem"
}
],
"draftWorkItem": null,
"$type": "IssueTimeTracker"
}