External worker conflates to identity 3P user

The Teamwork Graph API is coming soon. The object and relationship types documented here are indicative of what will be available in the Graph via the Teamwork Graph API. Please note that relationships, objects, their properties, and functionality may change before and during the Early Access Program.

Interested in early access? Express your interest in joining the EAP

Establishes the association between external workers and their corresponding third-party user identities. This relationship enables mapping of worker entities to external identity providers, supporting multi-platform identity resolution and unified user representation across integrated systems. Relationship type: Canonical

From object types	To object types
External Worker - `ati:cloud:graph:worker`	Identity Third Party User - `ati:cloud:identity:third-party-user`

Cypher

Note

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

GraphQL

1
2
query ExternalWorkerConflatesToIdentity3pUser_CypherQuery($cypherQuery: String!, $params: CypherRequestParams) {
  cypherQuery(query: $cypherQuery, params: $params) {
    edges {
      node {
        columns {
          value {
            ... on CypherQueryResultNode {
              id
              data {
                __typename
                ... on ThirdPartyUser {
                  id
                }
              }
            }
          }
        }
      }
    }
  }
}

Params

1
2
{
  "cypherQuery": "MATCH (worker:ExternalWorker {ari: $id})-[:external_worker_conflates_to_identity_3p_user]->(user:IdentityThirdPartyUser) RETURN user",
  "params": {
    "id": "$id"
  }
}

Inverse query

GraphQL

1
2
query ExternalWorkerConflatesToIdentity3pUser_CypherQuery($cypherQuery: String!, $params: CypherRequestParams) {
  cypherQuery(query: $cypherQuery, params: $params) {
    edges {
      node {
        columns {
          value {
            ... on CypherQueryResultNode {
              id
              data {
                __typename
                ... on ExternalWorker {
                  id
                }
              }
            }
          }
        }
      }
    }
  }
}

Params

1
2
{
  "cypherQuery": "MATCH (worker:ExternalWorker)-[:external_worker_conflates_to_identity_3p_user]->(user:IdentityThirdPartyUser {ari: $id}) RETURN worker",
  "params": {
    "id": "$id"
  }
}