YouTrack Standalone 2019.1 Help

Operations with Specific IssueTimeTracker

Resource

/api/issues/{issueID}/timeTracking

Returned entity

IssueTimeTracker. For the description of the entity attributes, see Supported Fields section.

Supported methods

IssueTimeTracker attributes

Time tracking settings of the project.

This table describes attributes of the IssueTimeTracker 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

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 IssueTimeTracker

This sub-resource let you operate work items of an issue and time tracking.

Request syntax

GET /api/issues/{issueID}/timeTracking/{trackerID}?{fields}

Request parameters

Parameter

Type

Description

fields

string

A list of IssueTimeTracker 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: 8 July 2019