entities

Contains definitions for the entities in YouTrack that are accessible to workflows.

Types

This module supports the following object types:

Type	Description
AbstractVcsItem	Represents VCS-related items such as commits and pull requests.
Agile	Represents an agile board and the set of sprints that belong to the board.
AppGlobalStorage	Entity type for App global extension properties
Article	Represents an article in YouTrack.
ArticleAttachment	Represents a file that is attached to an article.
ArticleComment	Represents a comment that is added to an article or an article draft.
BaseArticle	The base class for article.
BaseArticleAttachment	The base class for article comment.
BaseArticleComment	The base class for article comment.
BaseComment	The base class for issue comment.
BaseEntity	The common ancestor for all entity types.
BaseWorkItem	The base class for issue work items.
Build	Represents a value that is stored in a custom field that stores a build type.
BundleElementCondition	Represents a value-based condition for a custom field in a specific project.
BundleProjectCustomField	Represents a custom field in a project that stores a predefined set of values.
Calendar	Represents a group of business hours settings in a helpdesk project. In the Workflow API, such a group is called a Calendar.
Calendar24x7	Represents a group of 24x7 business hours settings in a helpdesk project. In the Workflow API, such a group is called a Calendar24x7.
ChangesProcessor	An entity that retrieves VCS changes and creates their representation in YouTrack.
Channel	Represents a channel used by customers to reach out to the helpdesk for support.
EnumField	Represents a value in a custom field that stores a predefined set of values.
FeedbackForm	Represents an online form used in a helpdesk project. Online forms provide customers with a web-based interface that they can use to submit inquiries, requests, or complaints.
Field	Represents a value that is stored in a custom field. The custom fields themselves are represented by the Fields class.
FieldBasedBundleValuesCondition	Represents a value-based condition for a custom field in a specific project.
FieldBasedUserValuesCondition	Represents a value-based condition for a custom field that stores references to users.
FieldBasedValuesCondition	Represents the base entity for a value-based condition for a custom field in a project.
Fields	Represents the custom fields that are used in an issue. The actual set of custom fields that are used for each issue is configured on a per-project basis. The properties shown here correspond with the default custom fields in YouTrack. Additional custom fields that have been attached to a project are also available.
Gantt	Represents a Gantt chart.
GroupProjectCustomField	Represents a custom field in a project that stores a UserGroup type.
Issue	Represents an issue in YouTrack. The `Issue` entity is the central entry point for workflow rules that read or modify issue data. In an issue-based rule, the issue currently being processed is available as `ctx.issue`.
IssueAttachment	Represents a file that is attached to an issue.
IssueComment	Represents a comment that is added to an issue.
IssueLinkPrototype	Represents an issue link type.
IssueTag	Deprecated. Use Tag instead.
IssueWorkItem	Represents a work item that has been added to an issue.
Iterator	An object that enables traversal through the elements in a collection.
JsonForArticleAddAttachment	Configures an attachment to add to an article in workflows and apps.
JsonForArticleAddComment	Configures a comment to add to an article in workflows and apps.
JsonForArticleConstructor	Configures the data used to create an article in workflows and apps.
JsonForIssueAddAttachment	Configures an attachment to add to an issue in workflows and apps.
JsonForIssueAddComment	Configures a comment to add to an issue in workflows and apps.
JsonForIssueAddWorkItem	Configures a work item to add to an issue in workflows and apps.
JsonForIssueCommentAddAttachment	Configures an attachment to add to an issue comment in workflows and apps.
JsonForIssueConstructor	Configures the data used to create an issue in workflows and apps.
JsonForUserNotify	Configures an email notification to send to a user in workflows and apps.
MailboxChannel	Represents an email channel used in a helpdesk project. Email channels pull messages from an external mail service and process them according to the channel settings.
OwnedField	Represents a value in a custom field that has a user associated with it, a so-called owner.
PeriodProjectCustomField	Represents a custom field in a project that stores a value as a period type. We use org.joda.time.Period as a base class for period values. While you can read the class documentation at http://joda-time.sourceforge.net/apidocs/org/joda/time/Period.html, please note that we support only class members which use the Period class and primitive types like String and int.
PersistentFile	Represents the common ancestor for all persistent files that are available in YouTrack.
Project	Represents a YouTrack project.
ProjectCustomField	Represents a custom field that is available in a project.
ProjectTeam	Represents a project team. To access a project team in a workflow, use the `team` property of a `Project` object, such as `ctx.issue.project.team`, or the `teams` property of a `User` object. In rule requirements, reference a project team as a `UserGroup` by name.
ProjectType	Represents a classification that determines which basic features are available for use in a project.
ProjectVersion	Represents a value in a custom field that stores a version type.
PullRequest	Represents a pull or merge request that is attached to an issue.
PullRequestState	Represents a pull request state.
Requirement	A single element in a set of Requirements
Requirements	The `requirements` object declares the fields and other YouTrack entities required by a workflow rule. Before running the rule, YouTrack validates these declarations and exposes the resolved entities in the workflow context.
SavedQuery	Represents a saved search.
Set	The `Set` object stores unique values of any type, whether primitive values or object references. The Set is used as storage for all multi-value objects in this API: custom fields that store multiple values, issue links, issues in a project, and so on. You can access single values in the collection directly (see `first()`, `last()`, `get(index)`), use an iterator (see `entries()`, `values()`), or traverse with `forEach(visitor)` and `find(predicate)` methods. The workflow API is based on ECMAScript 5.1. This Set implementation mimics the functionality supported by the ES 6 Set interface.
SimpleCalendar	Represents a work days calendar in YouTrack.
SimpleProjectCustomField	Base class for custom fields that store simple values like strings and numbers.
Sprint	Represents a sprint that is associated with an agile board. Each sprint can include issues from one or more projects.
State	Represents a value in a custom field that stores a state type.
Tag	Represents a tag.
TextProjectCustomField	Represents a custom field that stores a string of characters as text. When displayed in an issue, the text is shown as formatted in Markdown.
User	Represents a user account in YouTrack.
UserAttributes	Represents the collection of custom attributes that have been added to user profiles. To retrieve a value that is stored in the profile for a referenced user, use the attribute name as the key. The entire object is read-only.
UserCondition	Represents a value-based condition for a custom field in a specific project, where the field stores references to a user.
UserGroup	Represents a group of users.
UserProjectCustomField	Represents a custom field in a project that stores values as a user type.
UserType	Represents a classification that defines access to advanced helpdesk features and are used to regulate the pricing associated with each user account in YouTrack.
VcsChange	Represents a commit that is attached to an issue.
VcsServer	Represents a VCS server.
WatchFolder	Represents a common ancestor of classes that represent tags and saved searches.
WorkItemAttributeValue	Value of a work item attribute.
WorkItemAttributes	Represents the collection of custom attributes that have been declared for work items on a project level. To retrieve a value that is stored in an attribute for a referenced work item, use the attribute name as the key.
WorkItemProjectAttribute	Work item attribute configured for the project.
WorkItemType	Represents a work type that can be assigned to a work item.

Functions

actionFunction

actionFunction(ctx)

This function is called by different events depending on the rule type: when a change is applied to an issue (on-change rules), when a command is executed (action rules), or according to a predefined schedule (scheduled rules). This function is called separately for each related issue.

Parameters

Name	Type	Description
ctx	Object	The execution context. Along with the parameters listed below, the context also contains objects that you describe in the Requirements.

Properties of ctx

Name	Type	Description
issue	Issue	The current issue.
currentUser	User	The user who executes the rule.
isSilentOperation	Boolean	When `true`, the rule is triggered in reaction to a command that is applied without notification. When `false`, the rule is triggered in reaction to a command that is applied normally. Available since 2017.4.38771.
invokeAsync	function	Schedules an async function to run after the current transaction commits. The async function must be declared in the `asyncFunctions` block of the same rule or AI tool. Signature: `ctx.invokeAsync(functionName, delay, deduplicationKey)`. `functionName`-- string, required. Must match a key in `asyncFunctions`. `delay`-- number, optional. Specifies the delay in milliseconds. Defaults to `0`, can be up to 7 days. `deduplicationKey`-- string, optional. When it is set, YouTrack replaces any previously scheduled async call that uses the same key and entry configuration. For project-level rules, this means the same rule-project pair. For global-level rules, this means the same rule-global configuration pair. The old call is deleted, and the new call starts with a fresh delay. Use this parameter to debounce repeated events so only the latest invocation runs. Available since 2026.2.
store	function	Stores a value for use by subsequent async functions. Signature: `ctx.store(key, value)`. `key`-- string, required. The identifier of the stored value. `value`-- required. It can be a primitive (`string`, `number`, `boolean`), `null`, or an entity reference, for example an `Issue` or `User`. Stored values are available to subsequent async functions through `ctx.load(key)`. Values are persisted only when the same execution schedules an async function or async HTTP call. If no async call is scheduled, the values are discarded. Available since 2026.2.
load	function	Retrieves a value previously stored with `ctx.store(key, value)`. Signature: `ctx.load(key)`. `key` is required and must be a string identifier. This method returns the stored value. Any entity references are automatically resolved back to their entity objects. This method is available only inside async functions. Available since 2026.2.

Example

action: function(ctx) { console.log('Action for issue ' + ctx.issue.id); }

guardFunction

guardFunction(ctx)

This function is called to determine whether an action function can be applied to an issue. Guard functions are used in on-change rules, action rules, and in transitions between values of a state-machine rule. On-schedule rules also support guard functions, but this rule type includes a search property that has a similar purpose.

Parameters

Name	Type	Description
ctx	Object	The execution context. Along with the parameters listed below, the context also contains objects that you describe as Requirements.

Properties of ctx

Name	Type	Description
issue	Issue	The current issue.
currentUser	User	The user who executes the rule.

Example

guard: function(ctx) { return ctx.issue.State.isResolved; }

slaActionFunction

slaActionFunction(ctx)

This function is called when the SLA policy needs to update a ticket. For example, it can pause the timers according to the SLA pausing settings, or it can resume the timers when there is a new comment from the customer. Only SLA policy scripts use this function.

Parameters

Name	Type	Description
ctx	Object	The execution context. Along with the parameters listed below, the context also contains objects that you describe as Requirements.

Properties of ctx

Name	Type	Description
issue	Issue	The current ticket.
currentUser	User	The user who makes updates after which the SLA policy will update the ticket.

Example

action: (ctx) => { console.log('action', ctx.issue.id); }

slaBreachFunction

slaBreachFunction(ctx)

This function is called when one of the SLA goals is breached. Only SLA policy scripts use this function.

Parameters

Name	Type	Description
ctx	Object	The execution context. Along with the parameters listed below, the context also contains objects that you describe as Requirements.

Properties of ctx

Name	Type	Description
breachedField	Object	The timer custom field where the time goal has been breached for this ticket.
issue	Issue	The current ticket.
currentUser	User	The special workflow user that is considered to be the actor for triggering this function. This is a system user account that is granted a full set of permissions.

Example

onBreach: (ctx) => { console.log('onBreach', ctx.issue.id, ctx.breachedField); }

slaEnterFunction

slaEnterFunction(ctx)

This function is called when the SLA policy starts applying to the ticket. For example, it initialises the timers according to the SLA settings. Only SLA policy scripts use this function.

Parameters

Name	Type	Description
ctx	Object	The execution context. Along with the parameters listed below, the context also contains objects that you describe as Requirements.

Properties of ctx

Name	Type	Description
issue	Issue	The current ticket.
currentUser	User	The user who makes updates after which the SLA policy will be applied to this ticket.

Example

onEnter: (ctx) => { console.log('onEnter', ctx.issue.id); }

slaGuardFunction

slaGuardFunction(ctx)

This function is called to determine whether the SLA policy can be applied to a ticket. Only SLA policy scripts use this function.

Parameters

Name	Type	Description
ctx	Object	The execution context. Along with the parameters listed below, the context also contains objects that you describe as Requirements.

Properties of ctx

Name	Type	Description
issue	Issue	The current ticket.
currentUser	User	The user who makes updates after which the SLA policy will be applied to this ticket.

Example

guard: (ctx) => { return false; }

10 September 2026