Developer
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Object types
Relationship types
Last updated Jan 8, 2026

Jira work item status

The Teamwork Graph API is available through Forge's Early Access Program (EAP).

EAPs are offered to selected users for testing and feedback purposes. These features are unsupported and are subject to change without notice.

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 the status of a Jira work item indicating its current state in the workflow. Work item statuses track work progress through defined states like "To Do", "In Progress", or "Done".

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

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

FieldTypeDescription
descriptionStringOptional description of the status.
idID!Unique identifier for the status. This ID is globally unique across the entire Teamwork Graph.
nameStringName of status. E.g. Backlog, Selected for Development, In Progress, Done.
statusCategoryJiraStatusCategoryRepresents a group of Jira statuses.
statusIdIDStatus id in the digital format.

Fields for JiraStatusCategory

FieldTypeDescription
colorNameJiraStatusCategoryColorColor of status category.
idID!Global identifier for the Status Category.
keyStringA unique key to identify this status category. E.g. new, indeterminate, done.
nameStringName of status category. E.g. New, In Progress, Complete.
statusCategoryIdIDStatus category id in the digital format.

Values for JiraStatusCategoryColor

ValueDescription
BLUE_GRAYBlue gray color.
BROWNBrown color.
GREENGreen color.
MEDIUM_GRAYMedium gray color.
WARM_REDWarm red color.
YELLOWYellow color.

Available relationships

The following relationships are currently supported for Jira work item status:

Relationships where Jira work item status is the target object.

Relationship nameFrom object typeTo object type
Jira work item has changed Jira statusJira work itemJira work item status

Rate this page: