You must only install apps that call the Teamwork Graph API in test organizations. Apps calling the Teamwork Graph API require the read:graph:jiraor read:graph:confluence scope, which provides access to Teamwork Graph data across your entire organization. While apps still respect end-user permissions, this scope may grant access to sensitive information. For safety, only install these apps in organizations with test data. Do not install apps using this API in organizations with production data while this feature is in EAP.

Additionally, this EAP has significant limitations. To review the full list of limitations, see Limitations and considerations.

You must be part of this EAP in order to use the Teamwork Graph API. Express interest in joining through this form.

Represents a work item from Jira (issue, task, story, bug, etc.). Extends the base WorkItem interface with Jira-specific fields for user assignments.

Available fields and properties

The Teamwork Graph API has the following fields and properties that you can use in your queries:

Object type fields are the core data fields of the object. Use these when you want to retrieve specific information about the object in your queries.
Cypher query properties are metadata properties used for filtering and traversing relationships between different object types in Teamwork Graph. Use Cypher query properties when you need to filter or navigate relationships between this object and other objects in your queries.

Object type fields

Cypher query properties

Object type fields

You can access these fields in the GraphiQL playground using the book icon in the top left, and then searching for Jira work item.

Field	Type	Description
`assignee`	`User`	The user currently assigned to work on this Jira issue. May be null if unassigned.
`createdAt`	`DateTime`	Timestamp indicating when the Jira issue was originally created.
`description`	`String`	Detailed description of the Jira issue, which may include acceptance criteria, steps to reproduce, etc.
`dueAt`	`DateTime`	The due date for an issue
`id`	`ID!`	Unique identifier for the Jira work item. This ID is globally unique across the entire Teamwork Graph.
`issueId`	`ID`	Issue ID in numeric format. E.g. 10000
`issueType`	`JiraWorkItemType`	The issue type object for an issue
`key`	`String`	Jira issue key (e.g., "PROJ-123", "BUG-456"). This is the human-readable identifier used in Jira.
`reporter`	`User`	The user who reported or created this Jira issue.
`resolvedAt`	`DateTime`	The resolution date for an issue
`startedAt`	`DateTime`	The start date for an issue
`status`	`JiraWorkItemStatus`	The status for an issue
`summary`	`String`	Brief title or summary of the Jira issue.
`webUrl`	`URL`	The browser clickable link of this Issue.

Fields for JiraWorkItemType

Field	Type	Description
`avatar`	`JiraAvatar`	Avatar of the issue type.
`description`	`String`	Description of the issue type.
`id`	`ID!`	Unique identifier for the issue type. This ID is globally unique across the entire Teamwork Graph.
`name`	`String`	Name of the issue type. E.g. Story, Bug, Task, Epic.

Fields for JiraAvatar

Field	Type	Description
`large`	`String`	A large avatar (48x48 pixels).
`medium`	`String`	A medium avatar (32x32 pixels).
`small`	`String`	A small avatar (24x24 pixels).
`xsmall`	`String`	An extra-small avatar (16x16 pixels).

Fields for JiraWorkItemStatus

Field	Type	Description
`description`	`String`	Optional description of the status.
`id`	`ID!`	Unique identifier for the status. This ID is globally unique across the entire Teamwork Graph.
`name`	`String`	Name of status. E.g. Backlog, Selected for Development, In Progress, Done.
`statusCategory`	`JiraStatusCategory`	Represents a group of Jira statuses.
`statusId`	`ID`	Status id in the digital format.

Fields for JiraStatusCategory

Field	Type	Description
`colorName`	`JiraStatusCategoryColor`	Color of status category.
`id`	`ID!`	Global identifier for the Status Category.
`key`	`String`	A unique key to identify this status category. E.g. new, indeterminate, done.
`name`	`String`	Name of status category. E.g. New, In Progress, Complete.
`statusCategoryId`	`ID`	Status category id in the digital format.

Values for JiraStatusCategoryColor

Value	Description
`BLUE_GRAY`	Blue gray color.
`BROWN`	Brown color.
`GREEN`	Green color.
`MEDIUM_GRAY`	Medium gray color.
`WARM_RED`	Warm red color.
`YELLOW`	Yellow color.

Available relationships

The following relationships are currently supported for Jira work item:

From relationships

To relationships

Relationships where Jira work item is the source object.

Relationship name	From object type	To object type
Jira work item links external commit	Jira work item	External commit
Jira work item links support escalation entity	Jira work item	Jira space Jira work item
External message mentions Jira work item	Jira work item	External messages
Jira work item links external build	Jira work item	External build
Jira work item links external pull request	Jira work item	External pull request
JSM incident links Jira post incident review	Jira work item	Jira work item
Jira work item links external branch	Jira work item	External branch
Jira work item has Jira priority	Jira work item	Jira work item priority
Jira work item has child Jira work item	Jira work item	Jira work item
Jira work item links external deployment	Jira work item	External deployment
Jira work item links Confluence whiteboard	Jira work item	Confluence whiteboard
Jira work item links external feature flag	Jira work item	External feature flag
Jira work item has changed Jira priority	Jira work item	Jira work item priority
External conversation mentions Jira work item	Jira work item	External conversation
JSM incident links Jira work item	Jira work item	Jira work item
Jira work item has Jira work item comment	Jira work item	Jira work item comment
Jira work item links Jira work item	Jira work item	Jira work item
Jira work item contributes to Atlassian goal	Jira work item	Atlassian goal
Jira work item links external design	Jira work item	External design
Jira work item has changed Jira status	Jira work item	Jira work item status
Jira work item blocks Jira work item	Jira work item	Jira work item
JSM incident links JSM post incident review link	Jira work item	Jira work item