YouTrack Standalone 2020.3 Help

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

/api/issues/{issueID}/timeTracking

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-only.

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 entityID is returned

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" }
Last modified: 28 October 2020