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 unless you have an approved path to production.
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 status update for a Focus Area from Mercury, capturing status transitions, health changes, and target date modifications.
The Teamwork Graph API has the following fields and properties that you can use in your queries:
You can access these fields in the GraphiQL playground using the book icon in the top left, and then searching for Focus focus area status update.
| Field | Type | Description |
|---|---|---|
createdAt | DateTime | The date the update was created. |
creator | User | The user who created the update. |
focusAreaId | ID | The id of the Focus Area that is updated. |
id | ID! | The ID of the Focus Area status update. |
lastEditor | User | The user who last updated the update. Defaults to creator on create. |
newHealth | String | The new Focus Area health if the health was transitioned as part of the update. |
newStatus | String | The new Focus Area status if the status was transitioned as part of the update. |
newTargetDate | FocusFocusAreaTargetDate | The new target date if the date was changed as part of the update. |
previousHealth | String | The previous Focus Area health if the health was transitioned as part of the update. |
previousStatus | String | The previous Focus Area status if the status was transitioned as part of the update. |
previousTargetDate | FocusFocusAreaTargetDate | The previous target date if the date was changed as part of the update. |
summary | String | The summary text (ADF) for the update. |
updatedAt | DateTime | The date the update was last updated (edited). Defaults to createdAt on create. |
uuid | ID | The UUID of the Focus Area status update. |
| Field | Type | Description |
|---|---|---|
targetDate | DateTime | The target delivery date of the Focus Area. |
targetDateType | String | The target delivery date type. |
| Field | Type | Description |
|---|---|---|
targetDate | DateTime | The target delivery date of the Focus Area. |
targetDateType | String | The target delivery date type. |
Rate this page: