This version of GitHub Enterprise Server will be discontinued on 2026-08-25. 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.

Other

Reference documentation for GraphQL schema types in the Other category.

In this article

Queries

id

Query

ID of the object.

Type: ID!

relay

Query

Workaround for re-exposing the root query object. (Refer to https://github.com/facebook/relay/issues/112 for more information.).

Type: Query!

Mutations

addEnterpriseAdmin

Mutation

Adds an administrator to the global enterprise account.

Input fields for addEnterpriseAdmin

Return fields for addEnterpriseAdmin

NameDescription

admin (User)

The user who was added as an administrator.

clientMutationId (String)

A unique identifier for the client performing the mutation.

enterprise (Enterprise)

The updated enterprise.

role (EnterpriseAdministratorRole)

The role of the administrator.

viewer (User)

The viewer performing the mutation.

createTeamDiscussion

Mutation

Creates a new team discussion.

Input fields for createTeamDiscussion

Return fields for createTeamDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

teamDiscussion (TeamDiscussion)

The new discussion.

Warning

teamDiscussion is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

createTeamDiscussionComment

Mutation

Creates a new team discussion comment.

Input fields for createTeamDiscussionComment

Return fields for createTeamDiscussionComment

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

teamDiscussionComment (TeamDiscussionComment)

The new comment.

Warning

teamDiscussionComment is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

deleteTeamDiscussion

Mutation

Deletes a team discussion.

Input fields for deleteTeamDiscussion

Return fields for deleteTeamDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

deleteTeamDiscussionComment

Mutation

Deletes a team discussion comment.

Input fields for deleteTeamDiscussionComment

Return fields for deleteTeamDiscussionComment

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

updateEnterpriseTeamDiscussionsSetting

Mutation

Sets whether team discussions are enabled for an enterprise.

Input fields for updateEnterpriseTeamDiscussionsSetting

Return fields for updateEnterpriseTeamDiscussionsSetting

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

enterprise (Enterprise)

The enterprise with the updated team discussions setting.

message (String)

A message confirming the result of updating the team discussions setting.

updateTeamDiscussion

Mutation

Updates a team discussion.

Input fields for updateTeamDiscussion

Return fields for updateTeamDiscussion

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

teamDiscussion (TeamDiscussion)

The updated discussion.

updateTeamDiscussionComment

Mutation

Updates a discussion comment.

Input fields for updateTeamDiscussionComment

Return fields for updateTeamDiscussionComment

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

teamDiscussionComment (TeamDiscussionComment)

The updated comment.

Objects

PageInfo

Object

Information about pagination in a connection.

Fields for PageInfo

NameDescription

endCursor (String)

When paginating forwards, the cursor to continue.

hasNextPage (Boolean!)

When paginating forwards, are there more items?.

hasPreviousPage (Boolean!)

When paginating backwards, are there more items?.

startCursor (String)

When paginating backwards, the cursor to continue.

TeamDiscussion

Object

A team discussion.

TeamDiscussion Implements

Fields for TeamDiscussion

NameDescription

author (Actor)

The actor who authored the comment.

authorAssociation (CommentAuthorAssociation!)

Author's association with the discussion's team.

Warning

authorAssociation is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

body (String!)

The body as Markdown.

bodyHTML (HTML!)

The body rendered to HTML.

bodyText (String!)

The body rendered to text.

bodyVersion (String!)

Identifies the discussion body hash.

Warning

bodyVersion is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

comments (TeamDiscussionCommentConnection!)

A list of comments on this discussion.

Warning

comments is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

Arguments for comments

  • 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.

  • fromComment (Int)

    When provided, filters the connection such that results begin with the comment with this number.

  • last (Int)

    Returns the last n elements from the list.

commentsResourcePath (URI!)

The HTTP path for discussion comments.

Warning

commentsResourcePath is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

commentsUrl (URI!)

The HTTP URL for discussion comments.

Warning

commentsUrl is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

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 TeamDiscussion object.

includesCreatedEdit (Boolean!)

Check if this comment was edited and includes an edit with the creation data.

isPinned (Boolean!)

Whether or not the discussion is pinned.

Warning

isPinned is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

isPrivate (Boolean!)

Whether or not the discussion is only visible to team members and organization owners.

Warning

isPrivate is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

lastEditedAt (DateTime)

The moment the editor made the last edit.

number (Int!)

Identifies the discussion within its team.

Warning

number is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

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.

Arguments for reactions

  • 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 (ReactionOrder)

    Allows specifying the order in which reactions are returned.

resourcePath (URI!)

The HTTP path for this discussion.

Warning

resourcePath is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

team (Team!)

The team that defines the context of this discussion.

Warning

team is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

title (String!)

The title of the discussion.

Warning

title is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

updatedAt (DateTime!)

Identifies the date and time when the object was last updated.

url (URI!)

The HTTP URL for this discussion.

Warning

url is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

userContentEdits (UserContentEditConnection)

A list of edits to this content.

Arguments for userContentEdits

  • 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.

viewerCanDelete (Boolean!)

Check if the current viewer can delete this object.

viewerCanPin (Boolean!)

Whether or not the current viewer can pin this discussion.

Warning

viewerCanPin is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

viewerCanReact (Boolean!)

Can user react to this subject.

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.

viewerCannotUpdateReasons ([CommentCannotUpdateReason!]!)

Reasons why the current viewer can not update this comment.

viewerDidAuthor (Boolean!)

Did the viewer author this comment.

viewerSubscription (SubscriptionState)

Identifies if the viewer is watching, not watching, or ignoring the subscribable entity.

TeamDiscussionComment

Object

A comment on a team discussion.

TeamDiscussionComment Implements

Fields for TeamDiscussionComment

NameDescription

author (Actor)

The actor who authored the comment.

authorAssociation (CommentAuthorAssociation!)

Author's association with the comment's team.

Warning

authorAssociation is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

body (String!)

The body as Markdown.

bodyHTML (HTML!)

The body rendered to HTML.

bodyText (String!)

The body rendered to text.

bodyVersion (String!)

The current version of the body content.

Warning

bodyVersion is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

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.

discussion (TeamDiscussion!)

The discussion this comment is about.

Warning

discussion is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

editor (Actor)

The actor who edited the comment.

id (ID!)

The Node ID of the TeamDiscussionComment object.

includesCreatedEdit (Boolean!)

Check if this comment was edited and includes an edit with the creation data.

lastEditedAt (DateTime)

The moment the editor made the last edit.

number (Int!)

Identifies the comment number.

Warning

number is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

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.

Arguments for reactions

  • 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 (ReactionOrder)

    Allows specifying the order in which reactions are returned.

resourcePath (URI!)

The HTTP path for this comment.

Warning

resourcePath is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

updatedAt (DateTime!)

Identifies the date and time when the object was last updated.

url (URI!)

The HTTP URL for this comment.

Warning

url is deprecated.

The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.

userContentEdits (UserContentEditConnection)

A list of edits to this content.

Arguments for userContentEdits

  • 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.

viewerCanDelete (Boolean!)

Check if the current viewer can delete this object.

viewerCanReact (Boolean!)

Can user react to this subject.

viewerCanUpdate (Boolean!)

Check if the current viewer can update this object.

viewerCannotUpdateReasons ([CommentCannotUpdateReason!]!)

Reasons why the current viewer can not update this comment.

viewerDidAuthor (Boolean!)

Did the viewer author this comment.

TeamDiscussionCommentConnection

Object

The connection type for TeamDiscussionComment.

Fields for TeamDiscussionCommentConnection

NameDescription

edges ([TeamDiscussionCommentEdge])

A list of edges.

nodes ([TeamDiscussionComment])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

TeamDiscussionCommentEdge

Object

An edge in a connection.

Fields for TeamDiscussionCommentEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (TeamDiscussionComment)

The item at the end of the edge.

TeamDiscussionConnection

Object

The connection type for TeamDiscussion.

Fields for TeamDiscussionConnection

NameDescription

edges ([TeamDiscussionEdge])

A list of edges.

nodes ([TeamDiscussion])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

TeamDiscussionEdge

Object

An edge in a connection.

Fields for TeamDiscussionEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (TeamDiscussion)

The item at the end of the edge.

Interfaces

AnnouncementBannerI

Interface

Represents an announcement banner.

AnnouncementBannerI is implemented by

Fields for AnnouncementBannerI

NameDescription

announcement (String)

The text of the announcement.

Warning

announcement is deprecated.

The individual announcementX fields do not follow our standard GraphQL patterns. Use the announcementBanner object instead. Removal on 2025-04-01 UTC.

announcementCreatedAt (DateTime)

The date the announcement was created.

Warning

announcementCreatedAt is deprecated.

The individual announcementX fields do not follow our standard GraphQL patterns. Use the announcementBanner object instead. Removal on 2025-04-01 UTC.

announcementExpiresAt (DateTime)

The expiration date of the announcement, if any.

Warning

announcementExpiresAt is deprecated.

The individual announcementX fields do not follow our standard GraphQL patterns. Use the announcementBanner object instead. Removal on 2025-04-01 UTC.

announcementUserDismissible (Boolean)

Whether the announcement can be dismissed by the user.

Warning

announcementUserDismissible is deprecated.

The individual announcementX fields do not follow our standard GraphQL patterns. Use the announcementBanner object instead. Removal on 2025-04-01 UTC.

Enums

TeamDiscussionCommentOrderField

Enum

Properties by which team discussion comment connections can be ordered.

Values for TeamDiscussionCommentOrderField

NameDescription
NUMBER

Allows sequential ordering of team discussion comments (which is equivalent to chronological ordering).

Input objects

AddEnterpriseAdminInput

Input object

Autogenerated input type of AddEnterpriseAdmin.

Input fields for AddEnterpriseAdminInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise account to which the administrator should be added.

login (String!)

The login of the user to add as an administrator.

CreateTeamDiscussionCommentInput

Input object

Autogenerated input type of CreateTeamDiscussionComment.

Input fields for CreateTeamDiscussionCommentInput

NameDescription

body (String)

The content of the comment. This field is required.

Upcoming Change on 2024-07-01 UTC Description: body will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Reason: The Team Discussions feature is deprecated in favor of Organization Discussions.

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussionId (ID)

The ID of the discussion to which the comment belongs. This field is required.

Upcoming Change on 2024-07-01 UTC Description: discussionId will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Reason: The Team Discussions feature is deprecated in favor of Organization Discussions.

CreateTeamDiscussionInput

Input object

Autogenerated input type of CreateTeamDiscussion.

Input fields for CreateTeamDiscussionInput

NameDescription

body (String)

The content of the discussion. This field is required.

Upcoming Change on 2024-07-01 UTC Description: body will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Reason: The Team Discussions feature is deprecated in favor of Organization Discussions.

clientMutationId (String)

A unique identifier for the client performing the mutation.

private (Boolean)

If true, restricts the visibility of this discussion to team members and organization owners. If false or not specified, allows any organization member to view this discussion.

Upcoming Change on 2024-07-01 UTC Description: private will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Reason: The Team Discussions feature is deprecated in favor of Organization Discussions.

teamId (ID)

The ID of the team to which the discussion belongs. This field is required.

Upcoming Change on 2024-07-01 UTC Description: teamId will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Reason: The Team Discussions feature is deprecated in favor of Organization Discussions.

title (String)

The title of the discussion. This field is required.

Upcoming Change on 2024-07-01 UTC Description: title will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Reason: The Team Discussions feature is deprecated in favor of Organization Discussions.

DeleteTeamDiscussionCommentInput

Input object

Autogenerated input type of DeleteTeamDiscussionComment.

Input fields for DeleteTeamDiscussionCommentInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the comment to delete.

DeleteTeamDiscussionInput

Input object

Autogenerated input type of DeleteTeamDiscussion.

Input fields for DeleteTeamDiscussionInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The discussion ID to delete.

TeamDiscussionCommentOrder

Input object

Ways in which team discussion comment connections can be ordered.

Input fields for TeamDiscussionCommentOrder

NameDescription

direction (OrderDirection!)

The direction in which to order nodes.

field (TeamDiscussionCommentOrderField!)

The field by which to order nodes.

UpdateEnterpriseTeamDiscussionsSettingInput

Input object

Autogenerated input type of UpdateEnterpriseTeamDiscussionsSetting.

Input fields for UpdateEnterpriseTeamDiscussionsSettingInput

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the team discussions setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the team discussions setting on the enterprise.

UpdateTeamDiscussionCommentInput

Input object

Autogenerated input type of UpdateTeamDiscussionComment.

Input fields for UpdateTeamDiscussionCommentInput

NameDescription

body (String!)

The updated text of the comment.

bodyVersion (String)

The current version of the body content.

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the comment to modify.

UpdateTeamDiscussionInput

Input object

Autogenerated input type of UpdateTeamDiscussion.

Input fields for UpdateTeamDiscussionInput

NameDescription

body (String)

The updated text of the discussion.

bodyVersion (String)

The current version of the body content. If provided, this update operation will be rejected if the given version does not match the latest version on the server.

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node ID of the discussion to modify.

pinned (Boolean)

If provided, sets the pinned state of the updated discussion.

title (String)

The updated title of the discussion.

Scalars

Base64String

Scalar

A (potentially binary) string encoded using base64.

BigInt

Scalar

Represents non-fractional signed whole numeric values. Since the value may exceed the size of a 32-bit integer, it's encoded as a string.

Boolean

Scalar

Represents true or false values.

Date

Scalar

An ISO-8601 encoded date string.

DateTime

Scalar

An ISO-8601 encoded UTC date string.

Float

Scalar

Represents signed double-precision fractional values as specified by IEEE 754.

GitObjectID

Scalar

A Git object ID.

GitRefname

Scalar

A fully qualified reference name (e.g. refs/heads/master).

GitSSHRemote

Scalar

Git SSH string.

GitTimestamp

Scalar

An ISO-8601 encoded date string. Unlike the DateTime type, GitTimestamp is not converted in UTC.

HTML

Scalar

A string containing HTML code.

ID

Scalar

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

Int

Scalar

Represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

PreciseDateTime

Scalar

An ISO-8601 encoded UTC date string with millisecond precision.

String

Scalar

Represents textual data as UTF-8 character sequences. This type is most often used by GraphQL to represent free-form human-readable text.

URI

Scalar

An RFC 3986, RFC 3987, and RFC 6570 (level 4) compliant URI string.

X509Certificate

Scalar

A valid x509 certificate string.