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.