Last updated Oct 12, 2026

Jira work item links external build

The Teamwork Graph API is available through Forge's Preview release phase.

Preview features are available to all users and receive the same level of support as generally available features. Schemas, fields, and behavior may still change before general availability (GA), and breaking changes are subject to a minimum 1-month deprecation notice, announced in the Teamwork Graph changelog.

To review the current limitations, see Limitations and considerations.

To share feedback or report an issue, visit the Atlassian developer community.

The JiraWorkItemLinksExternalBuild relationship represents the link between a Jira work item and an External build within the Teamwork Graph. It allows you to:

Retrieve External builds associated with a specific Jira work item
Find which Jira work items are associated with an External build
Traverse and analyze issue-build relationships

Relationship type: Canonical

TTL (Time To Live): 365 days

From object types	To object types
Jira work item - `ati:cloud:jira:issue`	External build - `ati:cloud:jira:build, ati:cloud:graph:build`

Cypher

We recommend sending parameterized Cypher queries as below instead of embedding the parameters directly in the query string. This approach will help ensure better performance.

Forward query

Inverse query

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
query JiraWorkItemLinksExternalBuild_CypherQuery($cypherQuery: String!, $params: CypherRequestParams) {
  cypherQuery(query: $cypherQuery, params: $params) {
    edges {
      node {
        columns {
          value {
            ... on CypherQueryResultNode {
              id
              data {
                __typename
                ... on ExternalBuild {
                  id
                }
              }
            }
          }
        }
      }
    }
  }
}

Params

1
2
3
4
5
6
7
{
  "cypherQuery": "MATCH (item:JiraWorkItem {ari: $id})-[:jira_work_item_links_external_build]->(build:ExternalBuild) RETURN build",
  "params": {
    "id": "$id"
  }
}