Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Object types
Relationship types
Last updated Nov 17, 2026

Atlassian user is external worker

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.

New apps should use curated queries or persisted Cypher queries. Raw cypherQuery is unavailable to new apps; existing apps should follow Migrate from raw Cypher queries.

To review the current limitations, see Limitations and considerations.

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

The AtlassianUserIsExternalWorker relationship is a logical relationship that provides a unified view of External workers linked to a particular user via their third-party user identities.

Relationship type: Logical

From object typesTo object types
Atlassian user - ati:cloud:identity:userExternal worker - ati:cloud:graph:worker

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.

GraphQL

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

Params

1
2
3
4
5
6
7
{
  "cypherQuery": "MATCH (user:AtlassianUser {ari: $id})-[:atlassian_user_is_external_worker]->(worker:ExternalWorker) RETURN worker",
  "params": {
    "id": "$id"
  }
}

Rate this page: