YouTrack Standalone 2019.2 Help

Operations with Specific WorkItemType

This resource lets you configure work item types of the project.

Resource

/api/admin/projects/{projectID}/timeTrackingSettings/workItemTypes/{typeID}

Returned entity

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

Supported methods

WorkItemType attributes

Represents a work type that can be assigned to a work item.

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

name

String

The name of the work item type. Can be null.

autoAttached

Boolean

If true, this work item type is automatically added to a project, when you enable the time tracking for it.

Read a Specific WorkItemType

Read the attributes of the specific work item type in the project.

Request syntax

GET /api/admin/projects/{projectID}/timeTrackingSettings/workItemTypes/{typeID}?{fields}

{typeID}

Database ID of the work item type.

Request parameters

Parameter

Type

Description

fields

String

A list of WorkItemType 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/admin/projects/0-0/timeTrackingSettings/workItemTypes/65-2?fields=id,name,autoAttached

Sample response body

{ "name": "Documentation", "autoAttached": false, "id": "65-2", "$type": "WorkItemType" }

Delete a Specific WorkItemType

Detach the work item type from the project.

Request syntax

DELETE /api/admin/projects/{projectID}/timeTrackingSettings/workItemTypes/{typeID}

{typeID}

Database ID of the work item type.

Request parameters

Parameter

Type

Description

fields

String

A list of WorkItemType 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/admin/projects/0-0/timeTrackingSettings/workItemTypes/65-3
Last modified: 22 October 2019