User mentioned in conversation

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

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

The UserMentionedInConversation relationship represents the link between an Identity third-party user and an external conversation they were mentioned in within the Teamwork Graph. It allows you to:

Find third-party users who have been tagged or mentioned in specific external conversations
Track all external conversations where a third-party user has been tagged or mentioned
Traverse and analyze user-conversation relationships

Relationship type: Activity

From object type	To object type
Identity third-party user - `ati:cloud:identity:third-party-user`	External conversation - `ati:cloud:graph:conversation`

Cypher

We recommend using parameterized Cypher queries rather than placing parameters directly in the query string. This helps improve performance.

Forward query

GraphQL

1
2
query UserMentionedInConversation_CypherQuery($cypherQuery: String!, $params: JSON!) {
 graphStore @optIn(to: ["GraphStore", "GraphStoreCypherQueryV2"]) {
  cypherQueryV2(query: $cypherQuery, params: $params) {
   edges {
    node {
     columns {
      key
      value {. on GraphStoreCypherQueryV2NodeList {
        nodes {
         data {. on ExternalConversation {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on ExternalConversation {
          id
         }
        }
       }. on GraphStoreCypherQueryV2BooleanObject {
        bool_val: value
       }. on GraphStoreCypherQueryV2IntObject {
        int_val: value
       }. on GraphStoreCypherQueryV2FloatObject {
        float_val: value
       }. on GraphStoreCypherQueryV2StringObject {
        str_val: value
       }
      }
     }
    }
   }
  }
 }
}

Params

1
2
{
 "cypherQuery": "MATCH (user:IdentityThirdPartyUser {ari: $id})-[:user_mentioned_in_conversation]->(conversation:GraphConversation) RETURN conversation",
 "params": {
  "id": "$id"
 }
}

Inverse query

GraphQL

1
2
query UserMentionedInConversation_CypherQuery($cypherQuery: String!, $params: JSON!) {
 graphStore @optIn(to: ["GraphStore", "GraphStoreCypherQueryV2"]) {
  cypherQueryV2(query: $cypherQuery, params: $params) {
   edges {
    node {
     columns {
      key
      value {. on GraphStoreCypherQueryV2NodeList {
        nodes {
         data {. on ThirdPartyUser {
           id
          }. on AtlassianAccountUser {
           id
          }. on CustomerUser {
           id
          }. on AppUser {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on ThirdPartyUser {
          id
         }. on AtlassianAccountUser {
          id
         }. on CustomerUser {
          id
         }. on AppUser {
          id
         }
        }
       }. on GraphStoreCypherQueryV2BooleanObject {
        bool_val: value
       }. on GraphStoreCypherQueryV2IntObject {
        int_val: value
       }. on GraphStoreCypherQueryV2FloatObject {
        float_val: value
       }. on GraphStoreCypherQueryV2StringObject {
        str_val: value
       }
      }
     }
    }
   }
  }
 }
}

Params

1
2
{
 "cypherQuery": "MATCH (user:IdentityThirdPartyUser)-[:user_mentioned_in_conversation]->(conversation:GraphConversation {ari: $id}) RETURN user",
 "params": {
  "id": "$id"
 }
}