Reference documentation for GraphQL schema types in the Discussions category.
Adds a comment to a Discussion, possibly as a reply to another comment.
addDiscussionCommentinput (AddDiscussionCommentInput!):addDiscussionCommentclientMutationId (String): A unique identifier for the client performing the mutation.comment (DiscussionComment): The newly created discussion comment.Autogenerated input type of AddDiscussionComment.
AddDiscussionCommentInputbody (String!): The contents of the comment.clientMutationId (String): A unique identifier for the client performing the mutation.discussionId (ID!): The Node ID of the discussion to comment on.replyToId (ID): The Node ID of the discussion comment within this discussion to reply to.Vote for an option in a discussion poll.
addDiscussionPollVoteinput (AddDiscussionPollVoteInput!):addDiscussionPollVoteclientMutationId (String): A unique identifier for the client performing the mutation.pollOption (DiscussionPollOption): The poll option that a vote was added to.Autogenerated input type of AddDiscussionPollVote.
AddDiscussionPollVoteInputclientMutationId (String): A unique identifier for the client performing the mutation.pollOptionId (ID!): The Node ID of the discussion poll option to vote for.Add an upvote to a discussion or discussion comment.
addUpvoteinput (AddUpvoteInput!):addUpvoteclientMutationId (String): A unique identifier for the client performing the mutation.subject (Votable): The votable subject.Autogenerated input type of AddUpvote.
AddUpvoteInputclientMutationId (String): A unique identifier for the client performing the mutation.subjectId (ID!): The Node ID of the discussion or comment to upvote.Close a discussion.
closeDiscussioninput (CloseDiscussionInput!):closeDiscussionclientMutationId (String): A unique identifier for the client performing the mutation.discussion (Discussion): The discussion that was closed.Autogenerated input type of CloseDiscussion.
CloseDiscussionInputclientMutationId (String): A unique identifier for the client performing the mutation.discussionId (ID!): ID of the discussion to be closed.reason (DiscussionCloseReason): The reason why the discussion is being closed.Create a discussion.
createDiscussioninput (CreateDiscussionInput!):createDiscussionclientMutationId (String): A unique identifier for the client performing the mutation.discussion (Discussion): The discussion that was just created.Autogenerated input type of CreateDiscussion.
CreateDiscussionInputbody (String!): The body of the discussion.categoryId (ID!): The id of the discussion category to associate with this discussion.clientMutationId (String): A unique identifier for the client performing the mutation.repositoryId (ID!): The id of the repository on which to create the discussion.title (String!): The title of the discussion.Delete a discussion and all of its replies.
deleteDiscussioninput (DeleteDiscussionInput!):deleteDiscussionclientMutationId (String): A unique identifier for the client performing the mutation.discussion (Discussion): The discussion that was just deleted.Delete a discussion comment. If it has replies, wipe it instead.
deleteDiscussionCommentinput (DeleteDiscussionCommentInput!):deleteDiscussionCommentclientMutationId (String): A unique identifier for the client performing the mutation.comment (DiscussionComment): The discussion comment that was just deleted.Autogenerated input type of DeleteDiscussionComment.
DeleteDiscussionCommentInputclientMutationId (String): A unique identifier for the client performing the mutation.id (ID!): The Node id of the discussion comment to delete.Autogenerated input type of DeleteDiscussion.
DeleteDiscussionInputclientMutationId (String): A unique identifier for the client performing the mutation.id (ID!): The id of the discussion to delete.A discussion in a repository.
Implements: Closable, Comment, Deletable, Labelable, Lockable, Node, Reactable, RepositoryNode, Subscribable, Updatable, Votable
DiscussionactiveLockReason (LockReason): Reason that the conversation was locked.
answer (DiscussionComment): The comment chosen as this discussion's answer, if any.
answerChosenAt (DateTime): The time when a user chose this discussion's answer, if answered.
answerChosenBy (Actor): The user who chose this discussion's answer, if answered.
author (Actor): The actor who authored the discussion.
authorAssociation (CommentAuthorAssociation!): Author's association with the subject of the comment.
body (String!): The main text of the discussion post.
bodyHTML (HTML!): The body rendered to HTML.
bodyText (String!): The body rendered to text.
category (DiscussionCategory!): The category for this discussion.
closed (Boolean!): Indicates if the object is closed (definition of closed may depend on type).
closedAt (DateTime): Identifies the date and time when the object was closed.
comments (DiscussionCommentConnection!): The replies to the discussion. (Pagination: after, before, first, last)
createdAt (DateTime!): Identifies the date and time when the object was created.
createdViaEmail (Boolean!): Check if this comment was created via an email reply.
databaseId (Int): Identifies the primary key from the database.
editor (Actor): The actor who edited the comment.
id (ID!): The Node ID of the Discussion object.
includesCreatedEdit (Boolean!): Check if this comment was edited and includes an edit with the creation data.
isAnswered (Boolean): Only return answered/unanswered discussions.
labels (LabelConnection): A list of labels associated with the object.
after (String): Returns the elements in the list that come after the specified cursor.before (String): Returns the elements in the list that come before the specified cursor.first (Int): Returns the first n elements from the list.last (Int): Returns the last n elements from the list.orderBy (LabelOrder): Ordering options for labels returned from the connection. Default: {field: CREATED_AT, direction: ASC}.lastEditedAt (DateTime): The moment the editor made the last edit.
locked (Boolean!): true if the object is locked.
number (Int!): The number identifying this discussion within the repository.
poll (DiscussionPoll): The poll associated with this discussion, if one exists.
publishedAt (DateTime): Identifies when the comment was published at.
reactionGroups ([ReactionGroup!]): A list of reactions grouped by content left on the subject.
reactions (ReactionConnection!): A list of Reactions left on the Issue.
after (String): Returns the elements in the list that come after the specified cursor.before (String): Returns the elements in the list that come before the specified cursor.content (ReactionContent): Allows filtering Reactions by emoji.first (Int): Returns the first n elements from the list.last (Int): Returns the last n elements from the list.orderBy (ReactionOrder): Allows specifying the order in which reactions are returned.repository (Repository!): The repository associated with this node.
resourcePath (URI!): The path for this discussion.
stateReason (DiscussionStateReason): Identifies the reason for the discussion's state.
title (String!): The title of this discussion.
updatedAt (DateTime!): Identifies the date and time when the object was last updated.
upvoteCount (Int!): Number of upvotes that this subject has received.
url (URI!): The URL for this discussion.
userContentEdits (UserContentEditConnection): A list of edits to this content. (Pagination: after, before, first, last)
viewerCanClose (Boolean!): Indicates if the object can be closed by the viewer.
viewerCanDelete (Boolean!): Check if the current viewer can delete this object.
viewerCanLabel (Boolean!): Indicates if the viewer can edit labels for this object.
viewerCanReact (Boolean!): Can user react to this subject.
viewerCanReopen (Boolean!): Indicates if the object can be reopened by the viewer.
viewerCanSubscribe (Boolean!): Check if the viewer is able to change their subscription status for the repository.
viewerCanUpdate (Boolean!): Check if the current viewer can update this object.
viewerCanUpvote (Boolean!): Whether or not the current user can add or remove an upvote on this subject.
viewerDidAuthor (Boolean!): Did the viewer author this comment.
viewerHasUpvoted (Boolean!): Whether or not the current user has already upvoted this subject.
viewerSubscription (SubscriptionState): Identifies if the viewer is watching, not watching, or ignoring the subscribable entity.
A category for discussions in a repository.
Implements: Node, RepositoryNode
DiscussionCategorycreatedAt (DateTime!): Identifies the date and time when the object was created.description (String): A description of this category.emoji (String!): An emoji representing this category.emojiHTML (HTML!): This category's emoji rendered as HTML.id (ID!): The Node ID of the DiscussionCategory object.isAnswerable (Boolean!): Whether or not discussions in this category support choosing an answer with the markDiscussionCommentAsAnswer mutation.name (String!): The name of this category.repository (Repository!): The repository associated with this node.slug (String!): The slug of this category.updatedAt (DateTime!): Identifies the date and time when the object was last updated.The connection type for DiscussionCategory.
DiscussionCategoryConnectionedges ([DiscussionCategoryEdge]): A list of edges.nodes ([DiscussionCategory]): A list of nodes.pageInfo (PageInfo!): Information to aid in pagination.totalCount (Int!): Identifies the total count of items in the connection.An edge in a connection.
DiscussionCategoryEdgecursor (String!): A cursor for use in pagination.node (DiscussionCategory): The item at the end of the edge.The possible reasons for closing a discussion.
DiscussionCloseReasonDUPLICATE: The discussion is a duplicate of another.OUTDATED: The discussion is no longer relevant.RESOLVED: The discussion has been resolved.A comment on a discussion.
Implements: Comment, Deletable, Minimizable, Node, Reactable, Updatable, UpdatableComment, Votable
DiscussionCommentauthor (Actor): The actor who authored the comment.
authorAssociation (CommentAuthorAssociation!): Author's association with the subject of the comment.
body (String!): The body as Markdown.
bodyHTML (HTML!): The body rendered to HTML.
bodyText (String!): The body rendered to text.
createdAt (DateTime!): Identifies the date and time when the object was created.
createdViaEmail (Boolean!): Check if this comment was created via an email reply.
databaseId (Int): Identifies the primary key from the database.
deletedAt (DateTime): The time when this replied-to comment was deleted.
discussion (Discussion): The discussion this comment was created in.
editor (Actor): The actor who edited the comment.
id (ID!): The Node ID of the DiscussionComment object.
includesCreatedEdit (Boolean!): Check if this comment was edited and includes an edit with the creation data.
isAnswer (Boolean!): Has this comment been chosen as the answer of its discussion?.
isMinimized (Boolean!): Returns whether or not a comment has been minimized.
lastEditedAt (DateTime): The moment the editor made the last edit.
minimizedReason (String): Returns why the comment was minimized. One of abuse, off-topic,
outdated, resolved, duplicate, spam, and low-quality. Note that the
case and formatting of these values differs from the inputs to the
MinimizeComment mutation.
publishedAt (DateTime): Identifies when the comment was published at.
reactionGroups ([ReactionGroup!]): A list of reactions grouped by content left on the subject.
reactions (ReactionConnection!): A list of Reactions left on the Issue.
after (String): Returns the elements in the list that come after the specified cursor.before (String): Returns the elements in the list that come before the specified cursor.content (ReactionContent): Allows filtering Reactions by emoji.first (Int): Returns the first n elements from the list.last (Int): Returns the last n elements from the list.orderBy (ReactionOrder): Allows specifying the order in which reactions are returned.replies (DiscussionCommentConnection!): The threaded replies to this comment. (Pagination: after, before, first, last)
replyTo (DiscussionComment): The discussion comment this comment is a reply to.
resourcePath (URI!): The path for this discussion comment.
updatedAt (DateTime!): Identifies the date and time when the object was last updated.
upvoteCount (Int!): Number of upvotes that this subject has received.
url (URI!): The URL for this discussion comment.
userContentEdits (UserContentEditConnection): A list of edits to this content. (Pagination: after, before, first, last)
viewerCanDelete (Boolean!): Check if the current viewer can delete this object.
viewerCanMarkAsAnswer (Boolean!): Can the current user mark this comment as an answer?.
viewerCanMinimize (Boolean!): Check if the current viewer can minimize this object.
viewerCanReact (Boolean!): Can user react to this subject.
viewerCanUnmarkAsAnswer (Boolean!): Can the current user unmark this comment as an answer?.
viewerCanUnminimize (Boolean!): Check if the current viewer can unminimize this object.
viewerCanUpdate (Boolean!): Check if the current viewer can update this object.
viewerCanUpvote (Boolean!): Whether or not the current user can add or remove an upvote on this subject.
viewerCannotUpdateReasons ([CommentCannotUpdateReason!]!): Reasons why the current viewer can not update this comment.
viewerDidAuthor (Boolean!): Did the viewer author this comment.
viewerHasUpvoted (Boolean!): Whether or not the current user has already upvoted this subject.
The connection type for DiscussionComment.
DiscussionCommentConnectionedges ([DiscussionCommentEdge]): A list of edges.nodes ([DiscussionComment]): A list of nodes.pageInfo (PageInfo!): Information to aid in pagination.totalCount (Int!): Identifies the total count of items in the connection.An edge in a connection.
DiscussionCommentEdgecursor (String!): A cursor for use in pagination.node (DiscussionComment): The item at the end of the edge.The connection type for Discussion.
DiscussionConnectionedges ([DiscussionEdge]): A list of edges.nodes ([Discussion]): A list of nodes.pageInfo (PageInfo!): Information to aid in pagination.totalCount (Int!): Identifies the total count of items in the connection.An edge in a connection.
DiscussionEdgecursor (String!): A cursor for use in pagination.node (Discussion): The item at the end of the edge.Ways in which lists of discussions can be ordered upon return.
DiscussionOrderdirection (OrderDirection!): The direction in which to order discussions by the specified field.field (DiscussionOrderField!): The field by which to order discussions.Properties by which discussion connections can be ordered.
DiscussionOrderFieldCREATED_AT: Order discussions by creation time.UPDATED_AT: Order discussions by most recent modification time.A poll for a discussion.
Implements: Node
DiscussionPolldiscussion (Discussion): The discussion that this poll belongs to.
id (ID!): The Node ID of the DiscussionPoll object.
options (DiscussionPollOptionConnection): The options for this poll.
after (String): Returns the elements in the list that come after the specified cursor.before (String): Returns the elements in the list that come before the specified cursor.first (Int): Returns the first n elements from the list.last (Int): Returns the last n elements from the list.orderBy (DiscussionPollOptionOrder): How to order the options for the discussion poll. Default: {field: AUTHORED_ORDER, direction: ASC}.question (String!): The question that is being asked by this poll.
totalVoteCount (Int!): The total number of votes that have been cast for this poll.
viewerCanVote (Boolean!): Indicates if the viewer has permission to vote in this poll.
viewerHasVoted (Boolean!): Indicates if the viewer has voted for any option in this poll.
An option for a discussion poll.
Implements: Node
DiscussionPollOptionid (ID!): The Node ID of the DiscussionPollOption object.option (String!): The text for this option.poll (DiscussionPoll): The discussion poll that this option belongs to.totalVoteCount (Int!): The total number of votes that have been cast for this option.viewerHasVoted (Boolean!): Indicates if the viewer has voted for this option in the poll.The connection type for DiscussionPollOption.
DiscussionPollOptionConnectionedges ([DiscussionPollOptionEdge]): A list of edges.nodes ([DiscussionPollOption]): A list of nodes.pageInfo (PageInfo!): Information to aid in pagination.totalCount (Int!): Identifies the total count of items in the connection.An edge in a connection.
DiscussionPollOptionEdgecursor (String!): A cursor for use in pagination.node (DiscussionPollOption): The item at the end of the edge.Ordering options for discussion poll option connections.
DiscussionPollOptionOrderdirection (OrderDirection!): The ordering direction.field (DiscussionPollOptionOrderField!): The field to order poll options by.Properties by which discussion poll option connections can be ordered.
DiscussionPollOptionOrderFieldAUTHORED_ORDER: Order poll options by the order that the poll author specified when creating the poll.VOTE_COUNT: Order poll options by the number of votes it has.The possible states of a discussion.
DiscussionStateCLOSED: A discussion that has been closed.OPEN: A discussion that is open.The possible state reasons of a discussion.
DiscussionStateReasonDUPLICATE: The discussion is a duplicate of another.OUTDATED: The discussion is no longer relevant.REOPENED: The discussion was reopened.RESOLVED: The discussion has been resolved.Mark a discussion comment as the chosen answer for discussions in an answerable category.
markDiscussionCommentAsAnswerinput (MarkDiscussionCommentAsAnswerInput!):markDiscussionCommentAsAnswerclientMutationId (String): A unique identifier for the client performing the mutation.discussion (Discussion): The discussion that includes the chosen comment.Autogenerated input type of MarkDiscussionCommentAsAnswer.
MarkDiscussionCommentAsAnswerInputclientMutationId (String): A unique identifier for the client performing the mutation.id (ID!): The Node ID of the discussion comment to mark as an answer.A Pinned Discussion is a discussion pinned to a repository's index page.
Implements: Node, RepositoryNode
PinnedDiscussioncreatedAt (DateTime!): Identifies the date and time when the object was created.databaseId (Int): Identifies the primary key from the database.discussion (Discussion!): The discussion that was pinned.gradientStopColors ([String!]!): Color stops of the chosen gradient.id (ID!): The Node ID of the PinnedDiscussion object.pattern (PinnedDiscussionPattern!): Background texture pattern.pinnedBy (Actor!): The actor that pinned this discussion.preconfiguredGradient (PinnedDiscussionGradient): Preconfigured background gradient option.repository (Repository!): The repository associated with this node.updatedAt (DateTime!): Identifies the date and time when the object was last updated.The connection type for PinnedDiscussion.
PinnedDiscussionConnectionedges ([PinnedDiscussionEdge]): A list of edges.nodes ([PinnedDiscussion]): A list of nodes.pageInfo (PageInfo!): Information to aid in pagination.totalCount (Int!): Identifies the total count of items in the connection.An edge in a connection.
PinnedDiscussionEdgecursor (String!): A cursor for use in pagination.node (PinnedDiscussion): The item at the end of the edge.Preconfigured gradients that may be used to style discussions pinned within a repository.
PinnedDiscussionGradientBLUE_MINT: A gradient of blue to mint.BLUE_PURPLE: A gradient of blue to purple.PINK_BLUE: A gradient of pink to blue.PURPLE_CORAL: A gradient of purple to coral.RED_ORANGE: A gradient of red to orange.Preconfigured background patterns that may be used to style discussions pinned within a repository.
PinnedDiscussionPatternCHEVRON_UP: An upward-facing chevron pattern.DOT: A hollow dot pattern.DOT_FILL: A solid dot pattern.HEART_FILL: A heart pattern.PLUS: A plus sign pattern.ZAP: A lightning bolt pattern.Remove an upvote to a discussion or discussion comment.
removeUpvoteinput (RemoveUpvoteInput!):removeUpvoteclientMutationId (String): A unique identifier for the client performing the mutation.subject (Votable): The votable subject.Autogenerated input type of RemoveUpvote.
RemoveUpvoteInputclientMutationId (String): A unique identifier for the client performing the mutation.subjectId (ID!): The Node ID of the discussion or comment to remove upvote.Reopen a discussion.
reopenDiscussioninput (ReopenDiscussionInput!):reopenDiscussionclientMutationId (String): A unique identifier for the client performing the mutation.discussion (Discussion): The discussion that was reopened.Autogenerated input type of ReopenDiscussion.
ReopenDiscussionInputclientMutationId (String): A unique identifier for the client performing the mutation.discussionId (ID!): ID of the discussion to be reopened.Represents an author of discussions in repositories.
RepositoryDiscussionAuthorrepositoryDiscussions (DiscussionConnection!): Discussions this user has started.
after (String): Returns the elements in the list that come after the specified cursor.answered (Boolean): Filter discussions to only those that have been answered or not. Defaults tobefore (String): Returns the elements in the list that come before the specified cursor.first (Int): Returns the first n elements from the list.last (Int): Returns the last n elements from the list.orderBy (DiscussionOrder): Ordering options for discussions returned from the connection. Default: {field: CREATED_AT, direction: DESC}.repositoryId (ID): Filter discussions to only those in a specific repository.states ([DiscussionState!]): A list of states to filter the discussions by. Default: [].Represents an author of discussion comments in repositories.
RepositoryDiscussionCommentAuthorrepositoryDiscussionComments (DiscussionCommentConnection!): Discussion comments this user has authored.
after (String): Returns the elements in the list that come after the specified cursor.before (String): Returns the elements in the list that come before the specified cursor.first (Int): Returns the first n elements from the list.last (Int): Returns the last n elements from the list.onlyAnswers (Boolean): Filter discussion comments to only those that were marked as the answer. Default: false.repositoryId (ID): Filter discussion comments to only those in a specific repository.Unmark a discussion comment as the chosen answer for discussions in an answerable category.
unmarkDiscussionCommentAsAnswerinput (UnmarkDiscussionCommentAsAnswerInput!):unmarkDiscussionCommentAsAnswerclientMutationId (String): A unique identifier for the client performing the mutation.discussion (Discussion): The discussion that includes the comment.Autogenerated input type of UnmarkDiscussionCommentAsAnswer.
UnmarkDiscussionCommentAsAnswerInputclientMutationId (String): A unique identifier for the client performing the mutation.id (ID!): The Node ID of the discussion comment to unmark as an answer.Update a discussion.
updateDiscussioninput (UpdateDiscussionInput!):updateDiscussionclientMutationId (String): A unique identifier for the client performing the mutation.discussion (Discussion): The modified discussion.Update the contents of a comment on a Discussion.
updateDiscussionCommentinput (UpdateDiscussionCommentInput!):updateDiscussionCommentclientMutationId (String): A unique identifier for the client performing the mutation.comment (DiscussionComment): The modified discussion comment.Autogenerated input type of UpdateDiscussionComment.
UpdateDiscussionCommentInputbody (String!): The new contents of the comment body.clientMutationId (String): A unique identifier for the client performing the mutation.commentId (ID!): The Node ID of the discussion comment to update.Autogenerated input type of UpdateDiscussion.
UpdateDiscussionInputbody (String): The new contents of the discussion body.categoryId (ID): The Node ID of a discussion category within the same repository to change this discussion to.clientMutationId (String): A unique identifier for the client performing the mutation.discussionId (ID!): The Node ID of the discussion to update.title (String): The new discussion title.A subject that may be upvoted.
VotableupvoteCount (Int!): Number of upvotes that this subject has received.viewerCanUpvote (Boolean!): Whether or not the current user can add or remove an upvote on this subject.viewerHasUpvoted (Boolean!): Whether or not the current user has already upvoted this subject.