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.

Related Resources

Below you can find the list of resources that let you work with this entity.

Issue Time Tracking

Attributes

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: 7 November 2024