External conversation mentions Jira work item

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

The ExternalConversationMentionsJiraWorkItem relationship represents the link between a Jira issue and an external conversation within the Teamwork Graph. It allows you to:

Retrieve conversations mentioning a specific Jira issue
Find which Jira issues are mentioned in a conversation
Traverse and analyze issue-conversation-mention relationships

Relationship type: Canonical

From object types	To object types
External Conversation - `ati:cloud:graph:conversation`	Jira Issue - `ati:cloud:jira:issue`

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.

Inverse query

GraphQL

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

Params

1
2
{
  "cypherQuery": "MATCH (issue:JiraIssue)-[:external_conversation_mentions_jira_work_item]->(conversation:GraphConversation {ari: $id}) RETURN issue",
  "params": {
    "id": "$id"
  }
}

Forward query

GraphQL

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

Params

1
2
{
  "cypherQuery": "MATCH (issue:JiraIssue {ari: $id})-[:external_conversation_mentions_jira_work_item]->(conversation:GraphConversation) RETURN conversation",
  "params": {
    "id": "$id"
  }
}