Preview features are available to all users and receive the same level of support as generally available features. Schemas, fields, and behavior may still change before general availability (GA), and breaking changes are subject to a minimum 1-month deprecation notice, announced in the Teamwork Graph changelog.

To review the current limitations, see Limitations and considerations.

To share feedback or report an issue, visit the Atlassian developer community.

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.

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 status:

To relationships

Relationships where Jira work item status is the target object.

Relationship name	From object type	To object type
Content entity links entity	Confluence blog post Confluence comment Confluence page Jira work item Jira work item comment External branch External build External calendar event External comment External commit External conversation External data table External deployment External design External document External messages External project External pull request External repository External video External vulnerability External work item	Jira work item status
Jira work item has changed Jira status	Jira work item	Jira work item status