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
Last updated Oct 29, 2025

Relationship types (Coming soon)

The Teamwork Graph API will provide access to a range of relationship types that connect objects across Atlassian apps and connected external tools. These relationships will enable you to traverse and analyze the connections between users, projects, issues, content, and other objects.

This documentation provides early insight into the relationship types that are planned for the API, helping you understand the potential connections and use cases that will be supported. Note that these relationship types are subject to change before and during the EAP. You may also notice inconsistencies in naming conventions and terminology, which we are working to resolve.

Relationship categories

All relationships are categorized into three main types:

CategoryDescriptionExamples
CanonicalDirect, structural connections between objects. These are the primary relationships that define ownership, containment, and logical associations.
  • AtlasGoalHasContributor
  • ProjectHasIssue
  • ConfluenceSpaceHasConfluenceBlogpost
  • UserIsInTeam
ActivityUser actions and interactions with objects. These relationships capture behavioral data and change events.
  • UserCreatedIssue
  • UserUpdatedConfluencePage
  • UserViewedAtlasProject
  • UserAssignedIncident
EventTime-bound occurrences and state changes between objects. These capture specific events that happen in workflows.
  • IssueHasChangedStatus
  • IssueHasChangedPriority

Querying relationships

When available, all relationships will be queryable using both Cypher and GraphQL. See the individual relationship documentation pages for specific GraphQL and Cypher query examples.

Relationship metadata

Many relationships include additional metadata that provides context about the connection:

  • Timestamps - When relationships were created or last updated
  • User information - Who created or modified the relationship
  • Status data - Current state of connected entities
  • Workflow information - Process-specific details and properties

Rate this page: