You must only install apps that call the Teamwork Graph API in test organizations. Apps calling the Teamwork Graph API require the read:graph:jiraor read:graph:confluence scope, which provides access to Teamwork Graph data across your entire organization. While apps still respect end-user permissions, this scope may grant access to sensitive information. For safety, only install these apps in organizations with test data. Do not install apps using this API in organizations with production data while this feature is in EAP.

Additionally, this EAP has significant limitations. To review the full list of limitations, see Limitations and considerations.

You must be part of this EAP in order to use the Teamwork Graph API. Express interest in joining through this form.

Represents individual messages from external communication or messaging systems.

Available fields and properties

The Teamwork Graph API has the following fields and properties that you can use in your queries:

Object type fields are the core data fields of the object. Use these when you want to retrieve specific information about the object in your queries.
Cypher query properties are metadata properties used for filtering and traversing relationships between different object types in Teamwork Graph. Use Cypher query properties when you need to filter or navigate relationships between this object and other objects in your queries.

Object type fields

Cypher query properties

Object type fields

You can access these fields in the GraphiQL playground using the book icon in the top left, and then searching for External messages.

Field	Type	Description
`containerId`	`ID`	Identifier of the container (e.g., conversation, channel) that holds this message.
`createdAt`	`DateTime`	Timestamp when the message was created.
`createdBy`	`User`	User who created this message.
`description`	`String`	Description or summary of the message.
`displayName`	`String`	Display name or title of the message.
`externalId`	`ID`	Identifier of the message in the external system.
`hidden`	`Boolean`	Indicates whether the message is hidden from normal view.
`id`	`ID!`	Unique identifier for the message. This ID is globally unique across the entire Teamwork Graph.
`isPinned`	`Boolean`	Indicates whether the message is pinned in its conversation or channel.
`lastActiveAt`	`DateTime`	Timestamp of the last activity on this message (e.g., last reply, reaction).
`lastUpdatedAt`	`DateTime`	Timestamp of the most recent update to the message.
`lastUpdatedBy`	`User`	User who last updated this message.
`parentId`	`ID`	Identifier of the parent message if this is a reply in a thread.

Available relationships

The following relationships are currently supported for External messages:

From relationships

To relationships

Relationships where External messages is the source object.

Relationship name	From object type	To object type
External message has child external message	External messages	External messages