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 project from an external or third-party project management system integrated with the Teamwork Graph.
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 External project.
| Field | Type | Description |
|---|---|---|
assignee | User | User assigned to the project. |
createdAt | DateTime | Timestamp when the project was created. |
createdBy | User | User who created this project. |
description | String | Description of the project. |
displayName | String | Display name of the project as shown in the source system. |
dueAt | DateTime | Due date for when the project should be completed. |
environment | String | Environment associated with the project. |
externalId | ID | Identifier of the project in the external system. |
id | ID! | Unique identifier for the project. This ID is globally unique across the entire Teamwork Graph. |
key | String | Key or short identifier for the project. |
labels | [String] | Labels associated with the project. |
lastUpdatedAt | DateTime | Timestamp of the most recent update to the project. |
lastUpdatedBy | User | User who last updated this project. |
priority | String | Priority of the project. |
provider | ExternalProvider | Provider or integration that supplies this project. |
resolution | String | Resolution of the project. |
status | String | Current status of the project. |
statusCategory | String | Status category of the project. |
thirdPartyId | ID | Additional identifier used by the third-party system. |
url | URL | Direct URL to view the project in its source system. |
votesCount | Int | Number of votes on the project. |
watchersCount | Int | Number of watchers on the project. |
| Field | Type | Description |
|---|---|---|
id | ID! | Unique identifier for the external provider. |
logoUrl | URL | URL to the provider's logo image for UI display. |
name | String | Display name of the provider (e.g., "Google Drive", "Dropbox", "GitHub"). |
Rate this page: