Developer Portal for YouTrack and Hub Help

WorkItem

Represents a work item entity. Use it in an import script.

Extends SubItem.

Properties

Name

Type

Description

author

User

The author of the entity.

created

string

The date when the work item was created. The expected string format is one of those returned by the getTimestampFormats function.

duration

number

The duration of the work item in minutes.

id

string

The ID of the entity.

started

string

The date and time when the work started.

The same as created by default.

The expected string format is one of those returned by the getTimestampFormats function.

type

'workItem'

Identifies this object as a work item. YouTrack infers 'workItem' for values in DocumentFields.workItems, so you can omit this property.

updated

string

The date and time when the entity was last updated. The expected string format is one of those returned by the getTimestampFormats function.

updatedBy

User

The user who last updated the entity.

10 September 2026