Ways to integrate with Teamwork Graph

There are two main ways to integrate with Teamwork Graph: accessing data via the Teamwork Graph API, or adding data to Teamwork Graph using connectors.

Currently, an app can either call the Teamwork Graph API or provide a custom connector, but it can't do both at the same time.

Accessing data in Teamwork Graph (EAP)

Use the Teamwork Graph API to query unified data and relationships across Atlassian apps and connected tools, so you can power intelligent experiences in your apps.

Call the Teamwork Graph API

Adding data to Teamwork Graph (EAP)

Build connectors that bring data from external apps into the Teamwork Graph, making it searchable and actionable across Atlassian experiences.

Build a Teamwork Graph connector

Accessing data in Teamwork Graph (EAP)

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.

The Teamwork Graph API lets your apps access objects and relationships in the graph, giving you a single, consistent view of data from Atlassian and connected tools. With the Teamwork Graph API, you can:

Query the graph for objects and relationships.
Build apps that leverage unified data for analytics, reporting, workflow automation, and AI-powered features.

Adding data to Teamwork Graph (EAP)

Teamwork Graph connectors are available through Forge's Early Access Program (EAP).

EAPs are offered to selected users for testing and feedback purposes. We are currently working with a select group of EAP participants to get their apps production-ready and available for publishing on Marketplace.

If you are interested in joining this EAP, you can express interest through this form.

Teamwork Graph connectors bring data from external apps and tools into Teamwork Graph. Atlassian provides 100 out-of-the-box Teamwork Graph connectors that allow customers to connect popular tools to Teamwork Graph. With the Teamwork Graph connector module (EAP), you can now also build custom Teamwork Graph connectors to connect data from your app or other external tools to Teamwork Graph.

Teamwork Graph connectors work by:

Extracting data from the source system (e.g. Google Drive, Slack, a custom app).
Mapping that data to Teamwork Graph's object types and schemas.
Pushing the data into the graph via bulk APIs, including objects, users, groups, and their relationships.
Sending permissions and access control lists (ACLs) for each object, so data is secure and only visible to the right users.

Once in Teamwork Graph, this data can be used across Atlassian experiences like Rovo Search, Chat, Agents, and Atlassian Analytics. Note that currently, some experiences require additional configuration or code changes to enable data visibility.