Skip to main content

This version of GitHub Enterprise Server will be discontinued on 2026-09-22. Discontinued releases are not supported. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features in GitHub Enterprise Server, see Overview of the upgrade process. For help with the upgrade, GitHub Enterprise Support.

Discussions

Reference documentation for GraphQL schema types in the Discussions category.

Mutations

addDiscussionComment

Mutation

Adds a comment to a Discussion, possibly as a reply to another comment.

Input fields for addDiscussionComment

Return fields for addDiscussionComment

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

comment (DiscussionComment)

The newly created discussion comment.

addDiscussionPollVote

Mutation

Vote for an option in a discussion poll.

Input fields for addDiscussionPollVote

Return fields for addDiscussionPollVote

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

pollOption (DiscussionPollOption)

The poll option that a vote was added to.

addUpvote

Mutation

Add an upvote to a discussion or discussion comment.

Input fields for addUpvote

Return fields for addUpvote

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

subject (Votable)

The votable subject.

closeDiscussion

Mutation

Close a discussion.

Input fields for closeDiscussion

Return fields for closeDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussion (Discussion)

The discussion that was closed.

createDiscussion

Mutation

Create a discussion.

Input fields for createDiscussion

Return fields for createDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussion (Discussion)

The discussion that was just created.

deleteDiscussion

Mutation

Delete a discussion and all of its replies.

Input fields for deleteDiscussion

Return fields for deleteDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussion (Discussion)

The discussion that was just deleted.

deleteDiscussionComment

Mutation

Delete a discussion comment. If it has replies, wipe it instead.

Input fields for deleteDiscussionComment

Return fields for deleteDiscussionComment

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

comment (DiscussionComment)

The discussion comment that was just deleted.

markDiscussionCommentAsAnswer

Mutation

Mark a discussion comment as the chosen answer for discussions in an answerable category.

Input fields for markDiscussionCommentAsAnswer

Return fields for markDiscussionCommentAsAnswer

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussion (Discussion)

The discussion that includes the chosen comment.

removeUpvote

Mutation

Remove an upvote to a discussion or discussion comment.

Input fields for removeUpvote

Return fields for removeUpvote

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

subject (Votable)

The votable subject.

reopenDiscussion

Mutation

Reopen a discussion.

Input fields for reopenDiscussion

Return fields for reopenDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussion (Discussion)

The discussion that was reopened.

unmarkDiscussionCommentAsAnswer

Mutation

Unmark a discussion comment as the chosen answer for discussions in an answerable category.

Input fields for unmarkDiscussionCommentAsAnswer

Return fields for unmarkDiscussionCommentAsAnswer

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussion (Discussion)

The discussion that includes the comment.

updateDiscussion

Mutation

Update a discussion.

Input fields for updateDiscussion

Return fields for updateDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussion (Discussion)

The modified discussion.

updateDiscussionComment

Mutation

Update the contents of a comment on a Discussion.

Input fields for updateDiscussionComment

Return fields for updateDiscussionComment

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

comment (DiscussionComment)

The modified discussion comment.

Objects

Discussion

Object

A discussion in a repository.

Discussion Implements

Fields for Discussion

NameDescription

activeLockReason (