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	`GET`: Read a Specific IssueTimeTracking.

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

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: 30 March 2021