Developer Portal for YouTrack and Hub 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 the server, specify it explicitly in the fields request parameter.

  • To update an attribute, provide it in the body of a POST request.

Field

Type

Description

id

String

The ID of the issue time tracking settings. Read-only.

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

https://example.youtrack.cloud/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: 29 September 2022