Preview the new Team Discussions GraphQL API

We added new objects and mutations to our GraphQL API that allow you to read and manage team discussions. Team discussions is the first GraphQL feature to use a preview period. GraphQL previews work the same way as they do with our REST API. As always, if you want to find out about upcoming GraphQL schema changes, follow the GraphQL Changelog which now includes preview periods as well.

You can access the new objects and mutations during the preview period by providing a custom media type in the Accept header:

application/vnd.github.echo-preview+json

New GraphQL objects

• TeamDiscussion
• TeamDiscussionComment

New GraphQL fields

• Team.discussion
• Team.discussions
• Team.discussionsResourcePath
• Team.discussionsUrl

New GraphQL mutations

• createTeamDiscussion
• createTeamDiscussionComment
• deleteTeamDiscussion
• deleteTeamDiscussionComment
• updateTeamDiscussion
• updateTeamDiscussionComment

During the preview period, we may change aspects of the API based on developer feedback. If we do, we will not provide any advance notice of the changes, but we will announce them here on the developer blog.

We are really excited to see what integrations you develop around this API! If you have any questions or feedback, please let us know.