Work Item Types
This resource lets you read, update, and delete types of work items.
Resource | |
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. |
autoAttached | Boolean | If true, this work item type is automatically added to a project, when you enable the time tracking for it. |
Read a List of WorkItemTypes
Read the list of currently available work item types.
Request syntax
GET /api/admin/timeTrackingSettings/workItemTypes?{fields}&{$top}&{$skip}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 |
$skip | Int | Optional. Lets you set a number of returned entities to skip before returning the first one. |
$top | Int | Optional. Lets you specify the maximum number of entries that are returned in the response. |
Sample
Sample request URI
https://example.myjetbrains.com/youtrack/api/admin/timeTrackingSettings/workItemTypes?fields=id,name,url,autoAttachedSample response body
[
{
"autoAttached": true,
"name": "Development",
"id": "65-0",
"$type": "WorkItemType"
},
{
"autoAttached": true,
"name": "Testing",
"id": "65-1",
"$type": "WorkItemType"
},
{
"autoAttached": false,
"name": "Documentation",
"id": "65-2",
"$type": "WorkItemType"
},
{
"autoAttached": false,
"name": "R-n-D",
"id": "65-3",
"$type": "WorkItemType"
}
]Add a New WorkItemType
Create a new work item type. To create a new type, you must provide the name property in the request body.
Required permissions
Requires Low-level Admin Write OR Update Project permission.
Request syntax
POST /api/admin/timeTrackingSettings/workItemTypes?{fields}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 |