Last updated Oct 12, 2026

External deployment has external commit

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 ExternalDeploymentHasExternalCommit relationship represents the link between a deployment and the commits it contains within the Teamwork Graph. It allows you to:

Retrieve commits included in a specific deployment
Find all deployments that include a specific commit
Track and analyze deployment-commit relationships and deployment history

Relationship type: Canonical

TTL (Time To Live): 180 days

From object types	To object types
External deployment - `ati:cloud:jira:deployment, ati:cloud:graph:deployment`	External commit - `ati:cloud:jira:commit, ati:cloud:graph:commit`

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 ExternalDeploymentHasExternalCommit_CypherQuery($cypherQuery: String!, $params: CypherRequestParams) {
  cypherQuery(query: $cypherQuery, params: $params) {
    edges {
      node {
        columns {
          value {
            ... on CypherQueryResultNode {
              id
              data {
                __typename
                ... on ExternalCommit {
                  id
                }
              }
            }
          }
        }
      }
    }
  }
}

Params

1
2
3
4
5
6
7
{
  "cypherQuery": "MATCH (deployment:ExternalDeployment {ari: $id})-[:external_deployment_has_external_commit]->(commit:ExternalCommit) RETURN commit",
  "params": {
    "id": "$id"
  }
}