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.

Represents a code repository from Bitbucket or an external version control system.

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

Cypher query properties

Object type fields

You can access these fields in the GraphiQL playground using the book icon in the top left, and then searching for External repository.

Field	Type	Description
`avatarDescription`	`String`	Description of the repository avatar or icon.
`avatarUrl`	`URL`	URL to the repository avatar or icon image.
`createdBy`	`User`	User who created this repository.
`description`	`String`	Description of the repository.
`displayName`	`String`	Display name of the repository.
`forkOfId`	`ID`	Identifier of the repository this was forked from, if applicable.
`id`	`ID!`	Unique identifier for the repository. This ID is globally unique across the entire Teamwork Graph.
`lastUpdatedAt`	`DateTime`	Timestamp of the most recent update to the repository.
`lastUpdatedBy`	`User`	User who last updated this repository.
`name`	`String`	Name of the repository.
`provider`	`ExternalProvider`	Provider or integration that supplies this repository.
`repositoryId`	`ID`	Identifier of the repository in the external system.
`thirdPartyId`	`ID`	Additional identifier used by the third-party system.
`url`	`URL`	Direct URL to view the repository in its source system.

Fields for ExternalProvider

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").

Available relationships

The following relationships are currently supported for External repository:

To relationships

Relationships where External repository is the target object.

Relationship name	From object type	To object type
Jira space explicitly links external repository	Jira space	External repository
External deployment links external repository	External deployment	External repository
External repository has external pull request	External pull request	External repository
External repository has external commit	External commit	External repository
External service links external repository	External Service	External repository
Jira space unlinked external branch	Jira space	External repository
External repository has external branch	External branch	External repository