From 4fb212d5d1aa39661fe55676f3b0689fc01b4807 Mon Sep 17 00:00:00 2001 From: hubot Date: Fri, 18 Oct 2019 01:04:42 +0000 Subject: [PATCH] :arrow_up: GraphQL schema --- graphql/schema.graphql | 11751 +++++++++++++++++++++++++-------------- 1 file changed, 7697 insertions(+), 4054 deletions(-) diff --git a/graphql/schema.graphql b/graphql/schema.graphql index f313d3aca4..ff612d8348 100644 --- a/graphql/schema.graphql +++ b/graphql/schema.graphql @@ -7,6 +7,20 @@ input AcceptEnterpriseAdministratorInvitationInput { clientMutationId: String } +"""Autogenerated return type of AcceptEnterpriseAdministratorInvitation""" +type AcceptEnterpriseAdministratorInvitationPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The invitation that was accepted.""" + invitation: EnterpriseAdministratorInvitation + + """ + A message confirming the result of accepting an administrator invitation. + """ + message: String +} + """Autogenerated input type of AcceptTopicSuggestion""" input AcceptTopicSuggestionInput { """The Node ID of the repository.""" @@ -28,6 +42,21 @@ type AcceptTopicSuggestionPayload { topic: Topic } +"""The possible capabilities for action executions setting.""" +enum ActionExecutionCapabilitySetting { + """All action executions are disabled.""" + DISABLED + + """All action executions are enabled.""" + ALL_ACTIONS + + """Only actions defined within the repo are allowed.""" + LOCAL_ACTIONS_ONLY + + """Organization administrators action execution capabilities.""" + NO_POLICY +} + """ Represents an object which can take actions on GitHub. Typically a User or Bot. """ @@ -420,6 +449,9 @@ interface AuditEntry { """The time the action was initiated""" createdAt: PreciseDateTime! + """The corresponding operation type for the action""" + operationType: OperationType + """The user affected by the action""" user: User @@ -771,6 +803,20 @@ input CancelEnterpriseAdminInvitationInput { clientMutationId: String } +"""Autogenerated return type of CancelEnterpriseAdminInvitation""" +type CancelEnterpriseAdminInvitationPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The invitation that was canceled.""" + invitation: EnterpriseAdministratorInvitation + + """ + A message confirming the result of canceling an administrator invitation. + """ + message: String +} + """Autogenerated input type of ChangeUserStatus""" input ChangeUserStatusInput { """ @@ -1542,6 +1588,9 @@ enum CommentAuthorAssociation { """The possible errors that will prevent a user from updating a comment.""" enum CommentCannotUpdateReason { + """Unable to create comment because repository is archived.""" + ARCHIVED + """ You must be the author or have write access to this repository to update this comment. """ @@ -1601,7 +1650,7 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl last: Int """Ordering options for pull requests.""" - orderBy: PullRequestOrder + orderBy: PullRequestOrder = {field: CREATED_AT, direction: ASC} ): PullRequestConnection """Authorship details of the commit.""" @@ -1683,7 +1732,7 @@ type Commit implements Node & GitObject & Subscribable & UniformResourceLocatabl environments: [String!] """Ordering options for deployments returned from the connection.""" - orderBy: DeploymentOrder + orderBy: DeploymentOrder = {field: CREATED_AT, direction: ASC} """Returns the elements in the list that come after the specified cursor.""" after: String @@ -1846,7 +1895,7 @@ type CommitComment implements Node & Comment & Deletable & Updatable & Updatable """Identifies the comment body.""" body: String! - """Identifies the comment body rendered to HTML.""" + """The body rendered to HTML.""" bodyHTML: HTML! """The body rendered to text.""" @@ -2011,7 +2060,7 @@ type CommitCommentThread implements Node & RepositoryNode { ): CommitCommentConnection! """The commit the comments were made on.""" - commit: Commit! + commit: Commit id: ID! """The file the comments were made on.""" @@ -2078,7 +2127,7 @@ type CommitContributionsByRepository { """ Ordering options for commit contributions returned from the connection. """ - orderBy: CommitContributionOrder + orderBy: CommitContributionOrder = {field: OCCURRED_AT, direction: DESC} ): CreatedCommitContributionConnection! """The repository in which the commits were made.""" @@ -2360,7 +2409,7 @@ type ContributionsCollection { excludePopular: Boolean = false """Ordering options for contributions returned from the connection.""" - orderBy: ContributionOrder + orderBy: ContributionOrder = {field: OCCURRED_AT, direction: DESC} ): CreatedIssueContributionConnection! """Issue contributions made by the user, grouped by repository.""" @@ -2440,7 +2489,7 @@ type ContributionsCollection { excludePopular: Boolean = false """Ordering options for contributions returned from the connection.""" - orderBy: ContributionOrder + orderBy: ContributionOrder = {field: OCCURRED_AT, direction: DESC} ): CreatedPullRequestContributionConnection! """Pull request contributions made by the user, grouped by repository.""" @@ -2474,7 +2523,7 @@ type ContributionsCollection { last: Int """Ordering options for contributions returned from the connection.""" - orderBy: ContributionOrder + orderBy: ContributionOrder = {field: OCCURRED_AT, direction: DESC} ): CreatedPullRequestReviewContributionConnection! """ @@ -2507,7 +2556,7 @@ type ContributionsCollection { excludeFirst: Boolean = false """Ordering options for contributions returned from the connection.""" - orderBy: ContributionOrder + orderBy: ContributionOrder = {field: OCCURRED_AT, direction: DESC} ): CreatedRepositoryContributionConnection! """ @@ -2672,7 +2721,7 @@ input CreateBranchProtectionRuleInput { """Is pushing to matching branches restricted.""" restrictsPushes: Boolean - """A list of User or Team IDs allowed to push to matching branches.""" + """A list of User, Team or App IDs allowed to push to matching branches.""" pushActorIds: [ID!] """ @@ -3100,6 +3149,18 @@ input CreateEnterpriseOrganizationInput { clientMutationId: String } +"""Autogenerated return type of CreateEnterpriseOrganization""" +type CreateEnterpriseOrganizationPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The enterprise that owns the created organization.""" + enterprise: Enterprise + + """The organization that was created.""" + organization: Organization +} + """Autogenerated input type of CreateIssue""" input CreateIssueInput { """The Node ID of the repository.""" @@ -3284,6 +3345,58 @@ type CreateRepositoryPayload { repository: Repository } +"""Autogenerated input type of CreateTeamDiscussionComment""" +input CreateTeamDiscussionCommentInput { + """The ID of the discussion to which the comment belongs.""" + discussionId: ID! + + """The content of the comment.""" + body: String! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of CreateTeamDiscussionComment""" +type CreateTeamDiscussionCommentPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The new comment.""" + teamDiscussionComment: TeamDiscussionComment +} + +"""Autogenerated input type of CreateTeamDiscussion""" +input CreateTeamDiscussionInput { + """The ID of the team to which the discussion belongs.""" + teamId: ID! + + """The title of the discussion.""" + title: String! + + """The content of the discussion.""" + body: String! + + """ + If true, restricts the visiblity of this discussion to team members and + organization admins. If false or not specified, allows any organization member + to view this discussion. + """ + private: Boolean + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of CreateTeamDiscussion""" +type CreateTeamDiscussionPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The new discussion.""" + teamDiscussion: TeamDiscussion +} + """Represents a mention made by one issue or pull request to another.""" type CrossReferencedEvent implements Node & UniformResourceLocatable { """Identifies the actor who performed the event.""" @@ -3414,6 +3527,15 @@ type DeleteIssuePayload { repository: Repository } +"""Autogenerated input type of DeletePackageVersion""" +input DeletePackageVersionInput { + """The ID of the package version to be deleted.""" + packageVersionId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + """Autogenerated input type of DeleteProjectCard""" input DeleteProjectCardInput { """The id of the card to delete.""" @@ -3525,6 +3647,36 @@ type DeleteRefPayload { clientMutationId: String } +"""Autogenerated input type of DeleteTeamDiscussionComment""" +input DeleteTeamDiscussionCommentInput { + """The ID of the comment to delete.""" + id: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of DeleteTeamDiscussionComment""" +type DeleteTeamDiscussionCommentPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated input type of DeleteTeamDiscussion""" +input DeleteTeamDiscussionInput { + """The discussion ID to delete.""" + id: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of DeleteTeamDiscussion""" +type DeleteTeamDiscussionPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + """Represents a 'demilestoned' event on a given issue or pull request.""" type DemilestonedEvent implements Node { """Identifies the actor who performed the event.""" @@ -3871,109 +4023,52 @@ input DraftPullRequestReviewComment { body: String! } -"""Metadata for an audit entry containing enterprise account information.""" -interface EnterpriseAuditEntryData { - """The HTTP path for this enterprise.""" - enterpriseResourcePath: URI - - """The slug of the enterprise.""" - enterpriseSlug: String - - """The HTTP URL for this enterprise.""" - enterpriseUrl: URI -} - -"""An external identity provisioned by SAML SSO or SCIM.""" -type ExternalIdentity implements Node { - """The GUID for this identity""" - guid: String! - id: ID! - - """Organization invitation for this SCIM-provisioned external identity""" - organizationInvitation: OrganizationInvitation - - """SAML Identity attributes""" - samlIdentity: ExternalIdentitySamlAttributes - - """SCIM Identity attributes""" - scimIdentity: ExternalIdentityScimAttributes - - """ - User linked to this external identity. Will be NULL if this identity has not been claimed by an organization member. - """ - user: User -} - -"""The connection type for ExternalIdentity.""" -type ExternalIdentityConnection { - """A list of edges.""" - edges: [ExternalIdentityEdge] - - """A list of nodes.""" - nodes: [ExternalIdentity] - - """Information to aid in pagination.""" - pageInfo: PageInfo! - - """Identifies the total count of items in the connection.""" - totalCount: Int! -} - -"""An edge in a connection.""" -type ExternalIdentityEdge { - """A cursor for use in pagination.""" - cursor: String! +""" +An account to manage multiple organizations with consolidated policy and billing. +""" +type Enterprise implements Node { + """A URL pointing to the enterprise's public avatar.""" + avatarUrl( + """The size of the resulting square image.""" + size: Int + ): URI! - """The item at the end of the edge.""" - node: ExternalIdentity -} + """Enterprise billing information visible to enterprise billing managers.""" + billingInfo: EnterpriseBillingInfo -"""SAML attributes for the External Identity""" -type ExternalIdentitySamlAttributes { - """The NameID of the SAML identity""" - nameId: String -} + """Identifies the date and time when the object was created.""" + createdAt: DateTime! -"""SCIM attributes for the External Identity""" -type ExternalIdentityScimAttributes { - """The userName of the SCIM identity""" - username: String -} + """Identifies the primary key from the database.""" + databaseId: Int -"""The connection type for User.""" -type FollowerConnection { - """A list of edges.""" - edges: [UserEdge] + """The description of the enterprise.""" + description: String - """A list of nodes.""" - nodes: [User] + """The description of the enterprise as HTML.""" + descriptionHTML: HTML! + id: ID! - """Information to aid in pagination.""" - pageInfo: PageInfo! + """The location of the enterprise.""" + location: String - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """A list of users who are members of this enterprise.""" + members( + """Only return members within the organizations with these logins""" + organizationLogins: [String!] -"""The connection type for User.""" -type FollowingConnection { - """A list of edges.""" - edges: [UserEdge] + """The search string to look for.""" + query: String - """A list of nodes.""" - nodes: [User] + """Ordering options for members returned from the connection.""" + orderBy: EnterpriseMemberOrder = {field: LOGIN, direction: ASC} - """Information to aid in pagination.""" - pageInfo: PageInfo! + """The role of the user in the enterprise organization or server.""" + role: EnterpriseUserAccountMembershipRole - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """Only return members within the selected GitHub Enterprise deployment""" + deployment: EnterpriseUserDeployment -"""A Gist.""" -type Gist implements Node & Starrable & UniformResourceLocatable { - """A list of comments associated with the gist""" - comments( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -3987,25 +4082,19 @@ type Gist implements Node & Starrable & UniformResourceLocatable { """Returns the last _n_ elements from the list.""" last: Int - ): GistCommentConnection! - - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + ): EnterpriseMemberConnection! - """The gist description.""" - description: String + """The name of the enterprise.""" + name: String! - """The files in this gist.""" - files( - """The maximum number of files to return.""" - limit: Int = 10 + """A list of organizations that belong to this enterprise.""" + organizations( + """The search string to look for.""" + query: String - """The oid of the files to return""" - oid: GitObjectID - ): [GistFile] + """Ordering options for organizations returned from the connection.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} - """A list of forks associated with the gist""" - forks( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4019,32 +4108,19 @@ type Gist implements Node & Starrable & UniformResourceLocatable { """Returns the last _n_ elements from the list.""" last: Int + ): OrganizationConnection! - """Ordering options for gists returned from the connection""" - orderBy: GistOrder - ): GistConnection! - id: ID! - - """Identifies if the gist is a fork.""" - isFork: Boolean! - - """Whether the gist is public or not.""" - isPublic: Boolean! - - """The gist name.""" - name: String! - - """The gist owner.""" - owner: RepositoryOwner - - """Identifies when the gist was last pushed to.""" - pushedAt: DateTime + """Enterprise information only visible to enterprise owners.""" + ownerInfo: EnterpriseOwnerInfo - """The HTML path to this resource.""" + """The HTTP path for this enterprise.""" resourcePath: URI! - """A list of users who have starred this starrable.""" - stargazers( + """The HTTP URL for this enterprise.""" + url: URI! + + """A list of user accounts on this enterprise.""" + userAccounts( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4058,116 +4134,75 @@ type Gist implements Node & Starrable & UniformResourceLocatable { """Returns the last _n_ elements from the list.""" last: Int + ): EnterpriseUserAccountConnection! - """Order for connection""" - orderBy: StarOrder - ): StargazerConnection! + """Is the current viewer an admin of this enterprise?""" + viewerIsAdmin: Boolean! - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! + """The URL of the enterprise website.""" + websiteUrl: URI +} - """The HTTP URL for this Gist.""" - url: URI! +"""The connection type for User.""" +type EnterpriseAdministratorConnection { + """A list of edges.""" + edges: [EnterpriseAdministratorEdge] - """ - Returns a boolean indicating whether the viewing user has starred this starrable. - """ - viewerHasStarred: Boolean! -} + """A list of nodes.""" + nodes: [User] -"""Represents a comment on an Gist.""" -type GistComment implements Node & Comment & Deletable & Updatable & UpdatableComment { - """The actor who authored the comment.""" - author: Actor + """Information to aid in pagination.""" + pageInfo: PageInfo! - """Author's association with the gist.""" - authorAssociation: CommentAuthorAssociation! + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """Identifies the comment body.""" - body: String! +"""A User who is an administrator of an enterprise.""" +type EnterpriseAdministratorEdge { + """A cursor for use in pagination.""" + cursor: String! - """The comment body rendered to HTML.""" - bodyHTML: HTML! + """The item at the end of the edge.""" + node: User - """The body rendered to text.""" - bodyText: String! + """The role of the administrator.""" + role: EnterpriseAdministratorRole! +} +""" +An invitation for a user to become an owner or billing manager of an enterprise. +""" +type EnterpriseAdministratorInvitation implements Node { """Identifies the date and time when the object was created.""" createdAt: DateTime! - """Check if this comment was created via an email reply.""" - createdViaEmail: Boolean! + """The email of the person who was invited to the enterprise.""" + email: String - """Identifies the primary key from the database.""" - databaseId: Int + """The enterprise the invitation is for.""" + enterprise: Enterprise! + id: ID! - """The actor who edited the comment.""" - editor: Actor + """The user who was invited to the enterprise.""" + invitee: User - """The associated gist.""" - gist: Gist! - id: ID! + """The user who created the invitation.""" + inviter: User """ - Check if this comment was edited and includes an edit with the creation data + The invitee's pending role in the enterprise (owner or billing_manager). """ - includesCreatedEdit: Boolean! - - """Returns whether or not a comment has been minimized.""" - isMinimized: Boolean! - - """The moment the editor made the last edit""" - lastEditedAt: DateTime - - """Returns why the comment was minimized.""" - minimizedReason: String - - """Identifies when the comment was published at.""" - publishedAt: DateTime - - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! - - """A list of edits to this content.""" - userContentEdits( - """Returns the elements in the list that come after the specified cursor.""" - after: String - - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String - - """Returns the first _n_ elements from the list.""" - first: Int - - """Returns the last _n_ elements from the list.""" - last: Int - ): UserContentEditConnection - - """Check if the current viewer can delete this object.""" - viewerCanDelete: Boolean! - - """Check if the current viewer can minimize this object.""" - viewerCanMinimize: Boolean! - - """Check if the current viewer can update this object.""" - viewerCanUpdate: Boolean! - - """Reasons why the current viewer can not update this comment.""" - viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! - - """Did the viewer author this comment.""" - viewerDidAuthor: Boolean! + role: EnterpriseAdministratorRole! } -"""The connection type for GistComment.""" -type GistCommentConnection { +"""The connection type for EnterpriseAdministratorInvitation.""" +type EnterpriseAdministratorInvitationConnection { """A list of edges.""" - edges: [GistCommentEdge] + edges: [EnterpriseAdministratorInvitationEdge] """A list of nodes.""" - nodes: [GistComment] + nodes: [EnterpriseAdministratorInvitation] """Information to aid in pagination.""" pageInfo: PageInfo! @@ -4177,439 +4212,383 @@ type GistCommentConnection { } """An edge in a connection.""" -type GistCommentEdge { +type EnterpriseAdministratorInvitationEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: GistComment + node: EnterpriseAdministratorInvitation } -"""The connection type for Gist.""" -type GistConnection { - """A list of edges.""" - edges: [GistEdge] - - """A list of nodes.""" - nodes: [Gist] - - """Information to aid in pagination.""" - pageInfo: PageInfo! +"""Ordering options for enterprise administrator invitation connections""" +input EnterpriseAdministratorInvitationOrder { + """The field to order enterprise administrator invitations by.""" + field: EnterpriseAdministratorInvitationOrderField! - """Identifies the total count of items in the connection.""" - totalCount: Int! + """The ordering direction.""" + direction: OrderDirection! } -"""An edge in a connection.""" -type GistEdge { - """A cursor for use in pagination.""" - cursor: String! - - """The item at the end of the edge.""" - node: Gist +""" +Properties by which enterprise administrator invitation connections can be ordered. +""" +enum EnterpriseAdministratorInvitationOrderField { + """Order enterprise administrator member invitations by creation time""" + CREATED_AT } -"""A file in a gist.""" -type GistFile { - """ - The file name encoded to remove characters that are invalid in URL paths. - """ - encodedName: String - - """The gist file encoding.""" - encoding: String - - """The file extension from the file name.""" - extension: String +"""The possible administrator roles in an enterprise account.""" +enum EnterpriseAdministratorRole { + """Represents an owner of the enterprise account.""" + OWNER - """Indicates if this file is an image.""" - isImage: Boolean! + """Represents a billing manager of the enterprise account.""" + BILLING_MANAGER +} - """Whether the file's contents were truncated.""" - isTruncated: Boolean! +"""Metadata for an audit entry containing enterprise account information.""" +interface EnterpriseAuditEntryData { + """The HTTP path for this enterprise.""" + enterpriseResourcePath: URI - """The programming language this file is written in.""" - language: Language + """The slug of the enterprise.""" + enterpriseSlug: String - """The gist file name.""" - name: String + """The HTTP URL for this enterprise.""" + enterpriseUrl: URI +} - """The gist file size in bytes.""" - size: Int +""" +Enterprise billing information visible to enterprise billing managers and owners. +""" +type EnterpriseBillingInfo { + """The number of licenseable users/emails across the enterprise.""" + allLicensableUsersCount: Int! - """UTF8 text data or null if the file is binary""" - text( - """Optionally truncate the returned file to this length.""" - truncate: Int - ): String -} + """ + The number of data packs used by all organizations owned by the enterprise. + """ + assetPacks: Int! -"""Ordering options for gist connections""" -input GistOrder { - """The field to order repositories by.""" - field: GistOrderField! + """ + The bandwidth quota in GB for all organizations owned by the enterprise. + """ + bandwidthQuota: Float! - """The ordering direction.""" - direction: OrderDirection! -} + """ + The bandwidth usage in GB for all organizations owned by the enterprise. + """ + bandwidthUsage: Float! -"""Properties by which gist connections can be ordered.""" -enum GistOrderField { - """Order gists by creation time""" - CREATED_AT + """The bandwidth usage as a percentage of the bandwidth quota.""" + bandwidthUsagePercentage: Int! - """Order gists by update time""" - UPDATED_AT + """The storage quota in GB for all organizations owned by the enterprise.""" + storageQuota: Float! - """Order gists by push time""" - PUSHED_AT -} + """The storage usage in GB for all organizations owned by the enterprise.""" + storageUsage: Float! -"""The privacy of a Gist""" -enum GistPrivacy { - """Public""" - PUBLIC + """The storage usage as a percentage of the storage quota.""" + storageUsagePercentage: Int! - """Secret""" - SECRET + """ + The number of available licenses across all owned organizations based on the unique number of billable users. + """ + totalAvailableLicenses: Int! - """Gists that are public and secret""" - ALL + """The total number of licenses allocated.""" + totalLicenses: Int! } -"""Represents an actor in a Git commit (ie. an author or committer).""" -type GitActor { - """A URL pointing to the author's public avatar.""" - avatarUrl( - """The size of the resulting square image.""" - size: Int - ): URI! +""" +The possible values for the enterprise default repository permission setting. +""" +enum EnterpriseDefaultRepositoryPermissionSettingValue { + """ + Organizations in the enterprise choose default repository permissions for their members. + """ + NO_POLICY - """The timestamp of the Git action (authoring or committing).""" - date: GitTimestamp + """ + Organization members will be able to clone, pull, push, and add new collaborators to all organization repositories. + """ + ADMIN - """The email in the Git commit.""" - email: String + """ + Organization members will be able to clone, pull, and push all organization repositories. + """ + WRITE - """The name in the Git commit.""" - name: String + """ + Organization members will be able to clone and pull all organization repositories. + """ + READ """ - The GitHub user corresponding to the email field. Null if no such user exists. + Organization members will only be able to clone and pull public repositories. """ - user: User + NONE } """An edge in a connection.""" -type GitActorEdge { +type EnterpriseEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: GitActor + node: Enterprise } -"""Represents information about the GitHub instance.""" -type GitHubMetadata { - """Returns a String that's a SHA of `github-services`""" - gitHubServicesSha: GitObjectID! - - """IP addresses that users connect to for git operations""" - gitIpAddresses: [String!] +"""The possible values for an enabled/disabled enterprise setting.""" +enum EnterpriseEnabledDisabledSettingValue { + """The setting is enabled for organizations in the enterprise.""" + ENABLED - """IP addresses that service hooks are sent from""" - hookIpAddresses: [String!] + """The setting is disabled for organizations in the enterprise.""" + DISABLED - """IP addresses that the importer connects from""" - importerIpAddresses: [String!] + """There is no policy set for organizations in the enterprise.""" + NO_POLICY +} - """Whether or not users are verified""" - isPasswordAuthenticationVerifiable: Boolean! +"""The possible values for an enabled/no policy enterprise setting.""" +enum EnterpriseEnabledSettingValue { + """The setting is enabled for organizations in the enterprise.""" + ENABLED - """IP addresses for GitHub Pages' A records""" - pagesIpAddresses: [String!] + """There is no policy set for organizations in the enterprise.""" + NO_POLICY } -"""Represents a Git object.""" -interface GitObject { - """An abbreviated version of the Git object ID""" - abbreviatedOid: String! +""" +An identity provider configured to provision identities for an enterprise. +""" +type EnterpriseIdentityProvider implements Node { + """ + The digest algorithm used to sign SAML requests for the identity provider. + """ + digestMethod: SamlDigestAlgorithm - """The HTTP path for this Git object""" - commitResourcePath: URI! + """The enterprise this identity provider belongs to.""" + enterprise: Enterprise - """The HTTP URL for this Git object""" - commitUrl: URI! - id: ID! - - """The Git object ID""" - oid: GitObjectID! - - """The Repository the Git object belongs to""" - repository: Repository! -} + """ExternalIdentities provisioned by this identity provider.""" + externalIdentities( + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""A Git object ID.""" -scalar GitObjectID + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String -"""Information about a signature (GPG or S/MIME) on a Commit or Tag.""" -interface GitSignature { - """Email used to sign this object.""" - email: String! + """Returns the first _n_ elements from the list.""" + first: Int - """True if the signature is valid and verified by GitHub.""" - isValid: Boolean! + """Returns the last _n_ elements from the list.""" + last: Int + ): ExternalIdentityConnection! + id: ID! """ - Payload for GPG signing object. Raw ODB object without the signature header. + The x509 certificate used by the identity provider to sign assertions and responses. """ - payload: String! - - """ASCII-armored signature header from object.""" - signature: String! + idpCertificate: X509Certificate - """GitHub user corresponding to the email signing this commit.""" - signer: User + """The Issuer Entity ID for the SAML identity provider.""" + issuer: String """ - The state of this signature. `VALID` if signature is valid and verified by - GitHub, otherwise represents reason why signature is considered invalid. + Recovery codes that can be used by admins to access the enterprise if the identity provider is unavailable. """ - state: GitSignatureState! - - """True if the signature was made with GitHub's signing key.""" - wasSignedByGitHub: Boolean! -} - -"""The state of a Git signature.""" -enum GitSignatureState { - """Valid signature and verified by GitHub""" - VALID - - """Invalid signature""" - INVALID - - """Malformed signature""" - MALFORMED_SIG - - """Key used for signing not known to GitHub""" - UNKNOWN_KEY - - """Invalid email used for signing""" - BAD_EMAIL - - """Email used for signing unverified on GitHub""" - UNVERIFIED_EMAIL - - """Email used for signing not known to GitHub""" - NO_USER - - """Unknown signature type""" - UNKNOWN_SIG_TYPE - - """Unsigned""" - UNSIGNED + recoveryCodes: [String!] """ - Internal error - the GPG verification service is unavailable at the moment + The signature algorithm used to sign SAML requests for the identity provider. """ - GPGVERIFY_UNAVAILABLE - - """Internal error - the GPG verification service misbehaved""" - GPGVERIFY_ERROR + signatureMethod: SamlSignatureAlgorithm - """The usage flags for the key that signed this don't allow signing""" - NOT_SIGNING_KEY + """The URL endpoint for the identity provider's SAML SSO.""" + ssoUrl: URI +} - """Signing key expired""" - EXPIRED_KEY +"""An object that is a member of an enterprise.""" +union EnterpriseMember = User | EnterpriseUserAccount - """Valid signature, pending certificate revocation checking""" - OCSP_PENDING +"""The connection type for EnterpriseMember.""" +type EnterpriseMemberConnection { + """A list of edges.""" + edges: [EnterpriseMemberEdge] - """Valid siganture, though certificate revocation check failed""" - OCSP_ERROR + """A list of nodes.""" + nodes: [EnterpriseMember] - """The signing certificate or its chain could not be verified""" - BAD_CERT + """Information to aid in pagination.""" + pageInfo: PageInfo! - """One or more certificates in chain has been revoked""" - OCSP_REVOKED + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""Git SSH string""" -scalar GitSSHRemote - """ -An ISO-8601 encoded date string. Unlike the DateTime type, GitTimestamp is not converted in UTC. +A User who is a member of an enterprise through one or more organizations. """ -scalar GitTimestamp +type EnterpriseMemberEdge { + """A cursor for use in pagination.""" + cursor: String! -"""Represents a GPG signature on a Commit or Tag.""" -type GpgSignature implements GitSignature { - """Email used to sign this object.""" - email: String! + """Whether the user does not have a license for the enterprise.""" + isUnlicensed: Boolean! - """True if the signature is valid and verified by GitHub.""" - isValid: Boolean! + """The item at the end of the edge.""" + node: EnterpriseMember +} - """Hex-encoded ID of the key that signed this object.""" - keyId: String +"""Ordering options for enterprise member connections.""" +input EnterpriseMemberOrder { + """The field to order enterprise members by.""" + field: EnterpriseMemberOrderField! - """ - Payload for GPG signing object. Raw ODB object without the signature header. - """ - payload: String! + """The ordering direction.""" + direction: OrderDirection! +} - """ASCII-armored signature header from object.""" - signature: String! +"""Properties by which enterprise member connections can be ordered.""" +enum EnterpriseMemberOrderField { + """Order enterprise members by login""" + LOGIN - """GitHub user corresponding to the email signing this commit.""" - signer: User + """Order enterprise members by creation time""" + CREATED_AT +} +""" +The possible values for the enterprise members can create repositories setting. +""" +enum EnterpriseMembersCanCreateRepositoriesSettingValue { """ - The state of this signature. `VALID` if signature is valid and verified by - GitHub, otherwise represents reason why signature is considered invalid. + Organization administrators choose whether to allow members to create repositories. """ - state: GitSignatureState! - - """True if the signature was made with GitHub's signing key.""" - wasSignedByGitHub: Boolean! -} - -"""Represents a 'head_ref_deleted' event on a given pull request.""" -type HeadRefDeletedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + NO_POLICY - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """Members will be able to create public and private repositories.""" + ALL - """Identifies the Ref associated with the `head_ref_deleted` event.""" - headRef: Ref + """Members will be able to create only public repositories.""" + PUBLIC - """ - Identifies the name of the Ref associated with the `head_ref_deleted` event. - """ - headRefName: String! - id: ID! + """Members will be able to create only private repositories.""" + PRIVATE - """PullRequest referenced by event.""" - pullRequest: PullRequest! + """Members will not be able to create public or private repositories.""" + DISABLED } -"""Represents a 'head_ref_force_pushed' event on a given pull request.""" -type HeadRefForcePushedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor +"""The possible values for the members can make purchases setting.""" +enum EnterpriseMembersCanMakePurchasesSettingValue { + """The setting is enabled for organizations in the enterprise.""" + ENABLED - """Identifies the after commit SHA for the 'head_ref_force_pushed' event.""" - afterCommit: Commit + """The setting is disabled for organizations in the enterprise.""" + DISABLED +} +""" +The possible values we have for filtering Platform::Objects::User#enterprises. +""" +enum EnterpriseMembershipType { """ - Identifies the before commit SHA for the 'head_ref_force_pushed' event. + Returns all enterprises in which the user is a member, admin, or billing manager. """ - beforeCommit: Commit + ALL - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! + """Returns all enterprises in which the user is an admin.""" + ADMIN - """PullRequest referenced by event.""" - pullRequest: PullRequest! + """Returns all enterprises in which the user is a billing manager.""" + BILLING_MANAGER """ - Identifies the fully qualified ref name for the 'head_ref_force_pushed' event. + Returns all enterprises in which the user is a member of an org that is owned by the enterprise. """ - ref: Ref + ORG_MEMBERSHIP } -"""Represents a 'head_ref_restored' event on a given pull request.""" -type HeadRefRestoredEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor - - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! +"""Ordering options for enterprises.""" +input EnterpriseOrder { + """The field to order enterprises by.""" + field: EnterpriseOrderField! - """PullRequest referenced by event.""" - pullRequest: PullRequest! + """The ordering direction.""" + direction: OrderDirection! } -"""A string containing HTML code.""" -scalar HTML - -""" -The possible states in which authentication can be configured with an identity provider. -""" -enum IdentityProviderConfigurationState { - """Authentication with an identity provider is configured and enforced.""" - ENFORCED - - """ - Authentication with an identity provider is configured but not enforced. - """ - CONFIGURED - - """Authentication with an identity provider is not configured.""" - UNCONFIGURED +"""Properties by which enterprise connections can be ordered.""" +enum EnterpriseOrderField { + """Order enterprises by name""" + NAME } -"""Autogenerated input type of ImportProject""" -input ImportProjectInput { - """The name of the Organization or User to create the Project under.""" - ownerName: String! - - """The name of Project.""" - name: String! - - """The description of Project.""" - body: String +"""The connection type for Organization.""" +type EnterpriseOrganizationMembershipConnection { + """A list of edges.""" + edges: [EnterpriseOrganizationMembershipEdge] - """Whether the Project is public or not.""" - public: Boolean = false + """A list of nodes.""" + nodes: [Organization] - """A list of columns containing issues and pull requests.""" - columnImports: [ProjectColumnImport!]! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""An installation on a repository""" -type InstalledAppEdge { +"""An enterprise organization that a user is a member of.""" +type EnterpriseOrganizationMembershipEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: App + node: Organization + + """The role of the user in the enterprise membership.""" + role: EnterpriseUserAccountMembershipRole! } -"""Autogenerated input type of InviteEnterpriseAdmin""" -input InviteEnterpriseAdminInput { - """The ID of the enterprise to which you want to invite an administrator.""" - enterpriseId: ID! +"""The connection type for User.""" +type EnterpriseOutsideCollaboratorConnection { + """A list of edges.""" + edges: [EnterpriseOutsideCollaboratorEdge] - """The login of a user to invite as an administrator.""" - invitee: String + """A list of nodes.""" + nodes: [User] - """The email of the person to invite as an administrator.""" - email: String + """Information to aid in pagination.""" + pageInfo: PageInfo! - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """Identifies the total count of items in the connection.""" + totalCount: Int! } """ -An Issue is a place to discuss ideas, enhancements, tasks, and bugs for a project. +A User who is an outside collaborator of an enterprise through one or more organizations. """ -type Issue implements Node & Assignable & Closable & Comment & Updatable & UpdatableComment & Labelable & Lockable & Reactable & RepositoryNode & Subscribable & UniformResourceLocatable { - """Reason that the conversation was locked.""" - activeLockReason: LockReason +type EnterpriseOutsideCollaboratorEdge { + """A cursor for use in pagination.""" + cursor: String! - """A list of Users assigned to this object.""" - assignees( + """ + Whether the outside collaborator does not have a license for the enterprise. + """ + isUnlicensed: Boolean! + + """The item at the end of the edge.""" + node: User + + """The enterprise organization repositories this user is a member of.""" + repositories( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4623,33 +4602,18 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - ): UserConnection! - """The actor who authored the comment.""" - author: Actor - - """Author's association with the subject of the comment.""" - authorAssociation: CommentAuthorAssociation! - - """Identifies the body of the issue.""" - body: String! - - """Identifies the body of the issue rendered to HTML.""" - bodyHTML: HTML! - - """Identifies the body of the issue rendered to text.""" - bodyText: String! + """Ordering options for repositories.""" + orderBy: RepositoryOrder = {field: NAME, direction: ASC} + ): EnterpriseRepositoryInfoConnection! +} +"""Enterprise information only visible to enterprise owners.""" +type EnterpriseOwnerInfo { """ - `true` if the object is closed (definition of closed may depend on type) + A list of enterprise organizations configured with the provided action execution capabilities setting value. """ - closed: Boolean! - - """Identifies the date and time when the object was closed.""" - closedAt: DateTime - - """A list of comments associated with the Issue.""" - comments( + actionExecutionCapabilitySettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4663,28 +4627,22 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - ): IssueCommentConnection! - - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - """Check if this comment was created via an email reply.""" - createdViaEmail: Boolean! + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! - """Identifies the primary key from the database.""" - databaseId: Int + """A list of all of the administrators for this enterprise.""" + admins( + """The search string to look for.""" + query: String - """The actor who edited the comment.""" - editor: Actor - id: ID! + """The role to filter by.""" + role: EnterpriseAdministratorRole - """ - Check if this comment was edited and includes an edit with the creation data - """ - includesCreatedEdit: Boolean! + """Ordering options for administrators returned from the connection.""" + orderBy: EnterpriseMemberOrder = {field: LOGIN, direction: ASC} - """A list of labels associated with the object.""" - labels( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4698,22 +4656,12 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - ): LabelConnection - - """The moment the editor made the last edit""" - lastEditedAt: DateTime - - """`true` if the object is locked""" - locked: Boolean! - - """Identifies the milestone associated with the issue.""" - milestone: Milestone + ): EnterpriseAdministratorConnection! - """Identifies the issue number.""" - number: Int! - - """A list of Users that are participating in the Issue conversation.""" - participants( + """ + A list of users in the enterprise who currently have two-factor authentication disabled. + """ + affiliatedUsersWithTwoFactorDisabled( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4729,8 +4677,20 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat last: Int ): UserConnection! - """List of project cards associated with this issue.""" - projectCards( + """ + Whether or not affiliated users with two-factor authentication disabled exist in the enterprise. + """ + affiliatedUsersWithTwoFactorDisabledExist: Boolean! + + """ + The setting value for whether private repository forking is enabled for repositories in organizations in this enterprise. + """ + allowPrivateRepositoryForkingSetting: EnterpriseEnabledDisabledSettingValue! + + """ + A list of enterprise organizations configured with the provided private repository forking setting value. + """ + allowPrivateRepositoryForkingSettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4745,18 +4705,22 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - """A list of archived states to filter the cards by""" - archivedStates: [ProjectCardArchivedState] = [ARCHIVED, NOT_ARCHIVED] - ): ProjectCardConnection! + """The setting value to find organizations for.""" + value: Boolean! - """Identifies when the comment was published at.""" - publishedAt: DateTime + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! - """A list of reactions grouped by content left on the subject.""" - reactionGroups: [ReactionGroup!] + """ + The setting value for base repository permissions for organizations in this enterprise. + """ + defaultRepositoryPermissionSetting: EnterpriseDefaultRepositoryPermissionSettingValue! - """A list of Reactions left on the Issue.""" - reactions( + """ + A list of enterprise organizations configured with the provided default repository permission. + """ + defaultRepositoryPermissionSettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4771,33 +4735,15 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - """Allows filtering Reactions by emoji.""" - content: ReactionContent - - """Allows specifying the order in which reactions are returned.""" - orderBy: ReactionOrder - ): ReactionConnection! - - """The repository associated with this node.""" - repository: Repository! - - """The HTTP path for this issue""" - resourcePath: URI! - - """Identifies the state of the issue.""" - state: IssueState! - - """A list of events, comments, commits, etc. associated with the issue.""" - timelineItems( - """Filter timeline items by a `since` timestamp.""" - since: DateTime - - """Skips the first _n_ elements in the list.""" - skip: Int + """The permission to find organizations for.""" + value: DefaultRepositoryPermissionField! - """Filter timeline items by type.""" - itemTypes: [IssueTimelineItemsItemType!] + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! + """Enterprise Server installations owned by the enterprise.""" + enterpriseServerInstallations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4811,19 +4757,36 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - ): IssueTimelineItemsConnection! - """Identifies the issue title.""" - title: String! + """ + Whether or not to only return installations discovered via GitHub Connect. + """ + connectedOnly: Boolean = false - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! + """Ordering options for Enterprise Server installations returned.""" + orderBy: EnterpriseServerInstallationOrder = {field: HOST_NAME, direction: ASC} + ): EnterpriseServerInstallationConnection! - """The HTTP URL for this issue""" - url: URI! + """ + Whether or not the default repository permission is currently being updated. + """ + isUpdatingDefaultRepositoryPermission: Boolean! - """A list of edits to this content.""" - userContentEdits( + """ + Whether the two-factor authentication requirement is currently being enforced. + """ + isUpdatingTwoFactorRequirement: Boolean! + + """ + The setting value for whether organization members with admin permissions on a + repository can change repository visibility. + """ + membersCanChangeRepositoryVisibilitySetting: EnterpriseEnabledDisabledSettingValue! + + """ + A list of enterprise organizations configured with the provided can change repository visibility setting value. + """ + membersCanChangeRepositoryVisibilitySettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4837,93 +4800,68 @@ type Issue implements Node & Assignable & Closable & Comment & Updatable & Updat """Returns the last _n_ elements from the list.""" last: Int - ): UserContentEditConnection - """Can user react to this subject""" - viewerCanReact: Boolean! + """The setting value to find organizations for.""" + value: Boolean! + + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! """ - Check if the viewer is able to change their subscription status for the repository. + The setting value for whether members of organizations in the enterprise can create internal repositories. """ - viewerCanSubscribe: Boolean! - - """Check if the current viewer can update this object.""" - viewerCanUpdate: Boolean! - - """Reasons why the current viewer can not update this comment.""" - viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! - - """Did the viewer author this comment.""" - viewerDidAuthor: Boolean! + membersCanCreateInternalRepositoriesSetting: Boolean """ - Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. + The setting value for whether members of organizations in the enterprise can create private repositories. """ - viewerSubscription: SubscriptionState -} - -"""Represents a comment on an Issue.""" -type IssueComment implements Node & Comment & Deletable & Updatable & UpdatableComment & Reactable & RepositoryNode { - """The actor who authored the comment.""" - author: Actor - - """Author's association with the subject of the comment.""" - authorAssociation: CommentAuthorAssociation! - - """The body as Markdown.""" - body: String! + membersCanCreatePrivateRepositoriesSetting: Boolean - """The body rendered to HTML.""" - bodyHTML: HTML! - - """The body rendered to text.""" - bodyText: String! - - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - - """Check if this comment was created via an email reply.""" - createdViaEmail: Boolean! - - """Identifies the primary key from the database.""" - databaseId: Int + """ + The setting value for whether members of organizations in the enterprise can create public repositories. + """ + membersCanCreatePublicRepositoriesSetting: Boolean - """The actor who edited the comment.""" - editor: Actor - id: ID! + """ + The setting value for whether members of organizations in the enterprise can create repositories. + """ + membersCanCreateRepositoriesSetting: EnterpriseMembersCanCreateRepositoriesSettingValue """ - Check if this comment was edited and includes an edit with the creation data + A list of enterprise organizations configured with the provided repository creation setting value. """ - includesCreatedEdit: Boolean! + membersCanCreateRepositoriesSettingOrganizations( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """Returns whether or not a comment has been minimized.""" - isMinimized: Boolean! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Identifies the issue associated with the comment.""" - issue: Issue! + """Returns the first _n_ elements from the list.""" + first: Int - """The moment the editor made the last edit""" - lastEditedAt: DateTime + """Returns the last _n_ elements from the list.""" + last: Int - """Returns why the comment was minimized.""" - minimizedReason: String + """The setting to find organizations for.""" + value: OrganizationMembersCanCreateRepositoriesSettingValue! - """Identifies when the comment was published at.""" - publishedAt: DateTime + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! """ - Returns the pull request associated with the comment, if this comment was made on a - pull request. - + The setting value for whether members with admin permissions for repositories can delete issues. """ - pullRequest: PullRequest + membersCanDeleteIssuesSetting: EnterpriseEnabledDisabledSettingValue! - """A list of reactions grouped by content left on the subject.""" - reactionGroups: [ReactionGroup!] - - """A list of Reactions left on the Issue.""" - reactions( + """ + A list of enterprise organizations configured with the provided members can delete issues setting value. + """ + membersCanDeleteIssuesSettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4938,27 +4876,22 @@ type IssueComment implements Node & Comment & Deletable & Updatable & UpdatableC """Returns the last _n_ elements from the list.""" last: Int - """Allows filtering Reactions by emoji.""" - content: ReactionContent - - """Allows specifying the order in which reactions are returned.""" - orderBy: ReactionOrder - ): ReactionConnection! - - """The repository associated with this node.""" - repository: Repository! - - """The HTTP path for this issue comment""" - resourcePath: URI! + """The setting value to find organizations for.""" + value: Boolean! - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! - """The HTTP URL for this issue comment""" - url: URI! + """ + The setting value for whether members with admin permissions for repositories can delete or transfer repositories. + """ + membersCanDeleteRepositoriesSetting: EnterpriseEnabledDisabledSettingValue! - """A list of edits to this content.""" - userContentEdits( + """ + A list of enterprise organizations configured with the provided members can delete repositories setting value. + """ + membersCanDeleteRepositoriesSettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -4972,70 +4905,86 @@ type IssueComment implements Node & Comment & Deletable & Updatable & UpdatableC """Returns the last _n_ elements from the list.""" last: Int - ): UserContentEditConnection - """Check if the current viewer can delete this object.""" - viewerCanDelete: Boolean! + """The setting value to find organizations for.""" + value: Boolean! - """Check if the current viewer can minimize this object.""" - viewerCanMinimize: Boolean! + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! - """Can user react to this subject""" - viewerCanReact: Boolean! + """ + The setting value for whether members of organizations in the enterprise can invite outside collaborators. + """ + membersCanInviteCollaboratorsSetting: EnterpriseEnabledDisabledSettingValue! - """Check if the current viewer can update this object.""" - viewerCanUpdate: Boolean! + """ + A list of enterprise organizations configured with the provided members can invite collaborators setting value. + """ + membersCanInviteCollaboratorsSettingOrganizations( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """Reasons why the current viewer can not update this comment.""" - viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Did the viewer author this comment.""" - viewerDidAuthor: Boolean! -} + """Returns the first _n_ elements from the list.""" + first: Int -"""The connection type for IssueComment.""" -type IssueCommentConnection { - """A list of edges.""" - edges: [IssueCommentEdge] + """Returns the last _n_ elements from the list.""" + last: Int - """A list of nodes.""" - nodes: [IssueComment] + """The setting value to find organizations for.""" + value: Boolean! - """Information to aid in pagination.""" - pageInfo: PageInfo! + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """ + Indicates whether members of this enterprise's organizations can purchase additional services for those organizations. + """ + membersCanMakePurchasesSetting: EnterpriseMembersCanMakePurchasesSettingValue! -"""An edge in a connection.""" -type IssueCommentEdge { - """A cursor for use in pagination.""" - cursor: String! + """ + The setting value for whether members with admin permissions for repositories can update protected branches. + """ + membersCanUpdateProtectedBranchesSetting: EnterpriseEnabledDisabledSettingValue! - """The item at the end of the edge.""" - node: IssueComment -} + """ + A list of enterprise organizations configured with the provided members can update protected branches setting value. + """ + membersCanUpdateProtectedBranchesSettingOrganizations( + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""The connection type for Issue.""" -type IssueConnection { - """A list of edges.""" - edges: [IssueEdge] + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """A list of nodes.""" - nodes: [Issue] + """Returns the first _n_ elements from the list.""" + first: Int - """Information to aid in pagination.""" - pageInfo: PageInfo! + """Returns the last _n_ elements from the list.""" + last: Int - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """The setting value to find organizations for.""" + value: Boolean! -"""This aggregates issues opened by a user within one repository.""" -type IssueContributionsByRepository { - """The issue contributions.""" - contributions( + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! + + """The setting value for whether members can view dependency insights.""" + membersCanViewDependencyInsightsSetting: EnterpriseEnabledDisabledSettingValue! + + """ + A list of enterprise organizations configured with the provided members can view dependency insights setting value. + """ + membersCanViewDependencyInsightsSettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -5050,330 +4999,222 @@ type IssueContributionsByRepository { """Returns the last _n_ elements from the list.""" last: Int - """Ordering options for contributions returned from the connection.""" - orderBy: ContributionOrder - ): CreatedIssueContributionConnection! - - """The repository in which the issues were opened.""" - repository: Repository! -} - -"""An edge in a connection.""" -type IssueEdge { - """A cursor for use in pagination.""" - cursor: String! + """The setting value to find organizations for.""" + value: Boolean! - """The item at the end of the edge.""" - node: Issue -} + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! -"""Ways in which to filter lists of issues.""" -input IssueFilters { """ - List issues assigned to given name. Pass in `null` for issues with no assigned - user, and `*` for issues assigned to any user. + The setting value for whether organization projects are enabled for organizations in this enterprise. """ - assignee: String - - """List issues created by given name.""" - createdBy: String - - """List issues where the list of label names exist on the issue.""" - labels: [String!] - - """List issues where the given name is mentioned in the issue.""" - mentioned: String + organizationProjectsSetting: EnterpriseEnabledDisabledSettingValue! """ - List issues by given milestone argument. If an string representation of an - integer is passed, it should refer to a milestone by its number field. Pass in - `null` for issues with no milestone, and `*` for issues that are assigned to any milestone. + A list of enterprise organizations configured with the provided organization projects setting value. """ - milestone: String + organizationProjectsSettingOrganizations( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """List issues that have been updated at or after the given date.""" - since: DateTime + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """List issues filtered by the list of states given.""" - states: [IssueState!] + """Returns the first _n_ elements from the list.""" + first: Int - """List issues subscribed to by viewer.""" - viewerSubscribed: Boolean = false -} + """Returns the last _n_ elements from the list.""" + last: Int -"""Ways in which lists of issues can be ordered upon return.""" -input IssueOrder { - """The field in which to order issues by.""" - field: IssueOrderField! + """The setting value to find organizations for.""" + value: Boolean! - """The direction in which to order issues by the specified field.""" - direction: OrderDirection! -} + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! -"""Properties by which issue connections can be ordered.""" -enum IssueOrderField { - """Order issues by creation time""" - CREATED_AT + """ + A list of outside collaborators across the repositories in the enterprise. + """ + outsideCollaborators( + """The login of one specific outside collaborator.""" + login: String - """Order issues by update time""" - UPDATED_AT + """The search string to look for.""" + query: String - """Order issues by comment count""" - COMMENTS -} + """ + Ordering options for outside collaborators returned from the connection. + """ + orderBy: EnterpriseMemberOrder = {field: LOGIN, direction: ASC} -"""Used for return value of Repository.issueOrPullRequest.""" -union IssueOrPullRequest = Issue | PullRequest + """ + Only return outside collaborators on repositories with this visibility. + """ + visibility: RepositoryVisibility -"""An edge in a connection.""" -type IssueOrPullRequestEdge { - """A cursor for use in pagination.""" - cursor: String! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The item at the end of the edge.""" - node: IssueOrPullRequest -} + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String -"""The possible PubSub channels for an issue.""" -enum IssuePubSubTopic { - """The channel ID for observing issue updates.""" - UPDATED + """Returns the first _n_ elements from the list.""" + first: Int - """The channel ID for marking an issue as read.""" - MARKASREAD + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterpriseOutsideCollaboratorConnection! - """The channel ID for updating items on the issue timeline.""" - TIMELINE + """A list of pending administrator invitations for the enterprise.""" + pendingAdminInvitations( + """The search string to look for.""" + query: String - """The channel ID for observing issue state updates.""" - STATE -} + """ + Ordering options for pending enterprise administrator invitations returned from the connection. + """ + orderBy: EnterpriseAdministratorInvitationOrder = {field: CREATED_AT, direction: DESC} -"""The possible states of an issue.""" -enum IssueState { - """An issue that is still open""" - OPEN + """The role to filter by.""" + role: EnterpriseAdministratorRole - """An issue that has been closed""" - CLOSED -} + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""The connection type for IssueTimelineItem.""" -type IssueTimelineConnection { - """A list of edges.""" - edges: [IssueTimelineItemEdge] + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """A list of nodes.""" - nodes: [IssueTimelineItem] + """Returns the first _n_ elements from the list.""" + first: Int - """Information to aid in pagination.""" - pageInfo: PageInfo! + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterpriseAdministratorInvitationConnection! - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """ + A list of pending collaborators across the repositories in the enterprise. + """ + pendingCollaborators( + """The search string to look for.""" + query: String -"""An item in an issue timeline""" -union IssueTimelineItem = Commit | IssueComment | CrossReferencedEvent | ClosedEvent | ReopenedEvent | SubscribedEvent | UnsubscribedEvent | ReferencedEvent | AssignedEvent | UnassignedEvent | LabeledEvent | UnlabeledEvent | UserBlockedEvent | MilestonedEvent | DemilestonedEvent | RenamedTitleEvent | LockedEvent | UnlockedEvent | TransferredEvent + """ + Ordering options for pending repository collaborator invitations returned from the connection. + """ + orderBy: RepositoryInvitationOrder = {field: INVITEE_LOGIN, direction: ASC} -"""An edge in a connection.""" -type IssueTimelineItemEdge { - """A cursor for use in pagination.""" - cursor: String! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The item at the end of the edge.""" - node: IssueTimelineItem -} + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String -"""An item in an issue timeline""" -union IssueTimelineItems = IssueComment | CrossReferencedEvent | AddedToProjectEvent | AssignedEvent | ClosedEvent | CommentDeletedEvent | ConvertedNoteToIssueEvent | DemilestonedEvent | LabeledEvent | LockedEvent | MarkedAsDuplicateEvent | MentionedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UserBlockedEvent | UnpinnedEvent | UnsubscribedEvent + """Returns the first _n_ elements from the list.""" + first: Int -"""The connection type for IssueTimelineItems.""" -type IssueTimelineItemsConnection { - """A list of edges.""" - edges: [IssueTimelineItemsEdge] + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterprisePendingCollaboratorConnection! """ - Identifies the count of items after applying `before` and `after` filters. + A list of pending member invitations for organizations in the enterprise. """ - filteredCount: Int! + pendingMemberInvitations( + """The search string to look for.""" + query: String - """A list of nodes.""" - nodes: [IssueTimelineItems] - - """ - Identifies the count of items after applying `before`/`after` filters and `first`/`last`/`skip` slicing. - """ - pageCount: Int! - - """Information to aid in pagination.""" - pageInfo: PageInfo! - - """Identifies the total count of items in the connection.""" - totalCount: Int! - - """Identifies the date and time when the timeline was last updated.""" - updatedAt: DateTime! -} - -"""An edge in a connection.""" -type IssueTimelineItemsEdge { - """A cursor for use in pagination.""" - cursor: String! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The item at the end of the edge.""" - node: IssueTimelineItems -} + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String -"""The possible item types found in a timeline.""" -enum IssueTimelineItemsItemType { - """Represents a comment on an Issue.""" - ISSUE_COMMENT + """Returns the first _n_ elements from the list.""" + first: Int - """Represents a mention made by one issue or pull request to another.""" - CROSS_REFERENCED_EVENT + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterprisePendingMemberInvitationConnection! """ - Represents a 'added_to_project' event on a given issue or pull request. + The setting value for whether repository projects are enabled in this enterprise. """ - ADDED_TO_PROJECT_EVENT - - """Represents an 'assigned' event on any assignable object.""" - ASSIGNED_EVENT - - """Represents a 'closed' event on any `Closable`.""" - CLOSED_EVENT - - """Represents a 'comment_deleted' event on a given issue or pull request.""" - COMMENT_DELETED_EVENT + repositoryProjectsSetting: EnterpriseEnabledDisabledSettingValue! """ - Represents a 'converted_note_to_issue' event on a given issue or pull request. + A list of enterprise organizations configured with the provided repository projects setting value. """ - CONVERTED_NOTE_TO_ISSUE_EVENT - - """Represents a 'demilestoned' event on a given issue or pull request.""" - DEMILESTONED_EVENT - - """Represents a 'labeled' event on a given issue or pull request.""" - LABELED_EVENT - - """Represents a 'locked' event on a given issue or pull request.""" - LOCKED_EVENT + repositoryProjectsSettingOrganizations( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """ - Represents a 'marked_as_duplicate' event on a given issue or pull request. - """ - MARKED_AS_DUPLICATE_EVENT + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Represents a 'mentioned' event on a given issue or pull request.""" - MENTIONED_EVENT + """Returns the first _n_ elements from the list.""" + first: Int - """Represents a 'milestoned' event on a given issue or pull request.""" - MILESTONED_EVENT + """Returns the last _n_ elements from the list.""" + last: Int - """ - Represents a 'moved_columns_in_project' event on a given issue or pull request. - """ - MOVED_COLUMNS_IN_PROJECT_EVENT + """The setting value to find organizations for.""" + value: Boolean! - """Represents a 'pinned' event on a given issue or pull request.""" - PINNED_EVENT + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! - """Represents a 'referenced' event on a given `ReferencedSubject`.""" - REFERENCED_EVENT + """The SAML Identity Provider for the enterprise.""" + samlIdentityProvider: EnterpriseIdentityProvider """ - Represents a 'removed_from_project' event on a given issue or pull request. + A list of enterprise organizations configured with the SAML single sign-on setting value. """ - REMOVED_FROM_PROJECT_EVENT - - """Represents a 'renamed' event on a given issue or pull request""" - RENAMED_TITLE_EVENT - - """Represents a 'reopened' event on any `Closable`.""" - REOPENED_EVENT - - """Represents a 'subscribed' event on a given `Subscribable`.""" - SUBSCRIBED_EVENT - - """Represents a 'transferred' event on a given issue or pull request.""" - TRANSFERRED_EVENT - - """Represents an 'unassigned' event on any assignable object.""" - UNASSIGNED_EVENT + samlIdentityProviderSettingOrganizations( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """Represents an 'unlabeled' event on a given issue or pull request.""" - UNLABELED_EVENT + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Represents an 'unlocked' event on a given issue or pull request.""" - UNLOCKED_EVENT + """Returns the first _n_ elements from the list.""" + first: Int - """Represents a 'user_blocked' event on a given user.""" - USER_BLOCKED_EVENT + """Returns the last _n_ elements from the list.""" + last: Int - """Represents an 'unpinned' event on a given issue or pull request.""" - UNPINNED_EVENT + """The setting value to find organizations for.""" + value: IdentityProviderConfigurationState! - """Represents an 'unsubscribed' event on a given `Subscribable`.""" - UNSUBSCRIBED_EVENT -} + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! -"""Represents a user signing up for a GitHub account.""" -type JoinedGitHubContribution implements Contribution { """ - Whether this contribution is associated with a record you do not have access to. For - example, your own 'first issue' contribution may have been made on a repository you can no - longer access. - + The setting value for whether team discussions are enabled for organizations in this enterprise. """ - isRestricted: Boolean! - - """When this contribution was made.""" - occurredAt: DateTime! - - """The HTTP path for this contribution.""" - resourcePath: URI! - - """The HTTP URL for this contribution.""" - url: URI! + teamDiscussionsSetting: EnterpriseEnabledDisabledSettingValue! """ - The user who made this contribution. - + A list of enterprise organizations configured with the provided team discussions setting value. """ - user: User! -} - -"""A label for categorizing Issues or Milestones with a given Repository.""" -type Label implements Node { - """Identifies the label color.""" - color: String! - - """Identifies the date and time when the label was created.""" - createdAt: DateTime - - """A brief description of this label.""" - description: String - id: ID! - - """Indicates whether or not this is a default label.""" - isDefault: Boolean! - - """A list of issues associated with this label.""" - issues( - """Ordering options for issues returned from the connection.""" - orderBy: IssueOrder - - """A list of label names to filter the pull requests by.""" - labels: [String!] - - """A list of states to filter the issues by.""" - states: [IssueState!] - - """Filtering options for issues returned from the connection.""" - filterBy: IssueFilters - + teamDiscussionsSettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -5387,28 +5228,23 @@ type Label implements Node { """Returns the last _n_ elements from the list.""" last: Int - ): IssueConnection! - - """Identifies the label name.""" - name: String! - - """A list of pull requests associated with this label.""" - pullRequests( - """A list of states to filter the pull requests by.""" - states: [PullRequestState!] - - """A list of label names to filter the pull requests by.""" - labels: [String!] - """The head ref name to filter the pull requests by.""" - headRefName: String + """The setting value to find organizations for.""" + value: Boolean! - """The base ref name to filter the pull requests by.""" - baseRefName: String + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! - """Ordering options for pull requests returned from the connection.""" - orderBy: IssueOrder + """ + The setting value for whether the enterprise requires two-factor authentication for its organizations and users. + """ + twoFactorRequiredSetting: EnterpriseEnabledSettingValue! + """ + A list of enterprise organizations configured with the two-factor authentication setting value. + """ + twoFactorRequiredSettingOrganizations( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -5422,25 +5258,47 @@ type Label implements Node { """Returns the last _n_ elements from the list.""" last: Int - ): PullRequestConnection! - """The repository associated with this label.""" - repository: Repository! + """The setting value to find organizations for.""" + value: Boolean! - """The HTTP path for this label.""" - resourcePath: URI! + """Ordering options for organizations with this setting.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} + ): OrganizationConnection! +} - """Identifies the date and time when the label was last updated.""" - updatedAt: DateTime +"""The connection type for User.""" +type EnterprisePendingCollaboratorConnection { + """A list of edges.""" + edges: [EnterprisePendingCollaboratorEdge] - """The HTTP URL for this label.""" - url: URI! + """A list of nodes.""" + nodes: [User] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""An object that can have labels assigned to it.""" -interface Labelable { - """A list of labels associated with the object.""" - labels( +""" +A user with an invitation to be a collaborator on a repository owned by an organization in an enterprise. +""" +type EnterprisePendingCollaboratorEdge { + """A cursor for use in pagination.""" + cursor: String! + + """ + Whether the invited collaborator does not have a license for the enterprise. + """ + isUnlicensed: Boolean! + + """The item at the end of the edge.""" + node: User + + """The enterprise organization repositories this user is a member of.""" + repositories( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -5454,554 +5312,571 @@ interface Labelable { """Returns the last _n_ elements from the list.""" last: Int - ): LabelConnection + + """Ordering options for repositories.""" + orderBy: RepositoryOrder = {field: NAME, direction: ASC} + ): EnterpriseRepositoryInfoConnection! } -"""The connection type for Label.""" -type LabelConnection { +"""The connection type for OrganizationInvitation.""" +type EnterprisePendingMemberInvitationConnection { """A list of edges.""" - edges: [LabelEdge] + edges: [EnterprisePendingMemberInvitationEdge] """A list of nodes.""" - nodes: [Label] + nodes: [OrganizationInvitation] """Information to aid in pagination.""" pageInfo: PageInfo! """Identifies the total count of items in the connection.""" totalCount: Int! + + """Identifies the total count of unique users in the connection.""" + totalUniqueUserCount: Int! } -"""Represents a 'labeled' event on a given issue or pull request.""" -type LabeledEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor +"""An invitation to be a member in an enterprise organization.""" +type EnterprisePendingMemberInvitationEdge { + """A cursor for use in pagination.""" + cursor: String! - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! - - """Identifies the label associated with the 'labeled' event.""" - label: Label! - - """Identifies the `Labelable` associated with the event.""" - labelable: Labelable! -} - -"""An edge in a connection.""" -type LabelEdge { - """A cursor for use in pagination.""" - cursor: String! + """Whether the invitation has a license for the enterprise.""" + isUnlicensed: Boolean! """The item at the end of the edge.""" - node: Label + node: OrganizationInvitation } -"""Represents a given language found in repositories.""" -type Language implements Node { - """The color defined for the current language.""" - color: String +"""A subset of repository information queryable from an enterprise.""" +type EnterpriseRepositoryInfo implements Node { id: ID! - """The name of the current language.""" + """Identifies if the repository is private.""" + isPrivate: Boolean! + + """The repository's name.""" name: String! + + """The repository's name with owner.""" + nameWithOwner: String! } -"""A list of languages associated with the parent.""" -type LanguageConnection { +"""The connection type for EnterpriseRepositoryInfo.""" +type EnterpriseRepositoryInfoConnection { """A list of edges.""" - edges: [LanguageEdge] + edges: [EnterpriseRepositoryInfoEdge] """A list of nodes.""" - nodes: [Language] + nodes: [EnterpriseRepositoryInfo] """Information to aid in pagination.""" pageInfo: PageInfo! """Identifies the total count of items in the connection.""" totalCount: Int! - - """The total size in bytes of files written in that language.""" - totalSize: Int! } -"""Represents the language of a repository.""" -type LanguageEdge { +"""An edge in a connection.""" +type EnterpriseRepositoryInfoEdge { + """A cursor for use in pagination.""" cursor: String! - node: Language! - - """The number of bytes of code written in the language.""" - size: Int! -} -"""Ordering options for language connections.""" -input LanguageOrder { - """The field to order languages by.""" - field: LanguageOrderField! - - """The ordering direction.""" - direction: OrderDirection! + """The item at the end of the edge.""" + node: EnterpriseRepositoryInfo } -"""Properties by which language connections can be ordered.""" -enum LanguageOrderField { - """Order languages by the size of all files containing the language""" - SIZE -} +"""An Enterprise Server installation.""" +type EnterpriseServerInstallation implements Node { + """Identifies the date and time when the object was created.""" + createdAt: DateTime! -"""A repository's open source license""" -type License implements Node { - """The full text of the license""" - body: String! + """The customer name to which the Enterprise Server installation belongs.""" + customerName: String! - """The conditions set by the license""" - conditions: [LicenseRule]! + """The host name of the Enterprise Server installation.""" + hostName: String! + id: ID! - """A human-readable description of the license""" - description: String + """ + Whether or not the installation is connected to an Enterprise Server installation via GitHub Connect. + """ + isConnected: Boolean! - """Whether the license should be featured""" - featured: Boolean! + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! - """Whether the license should be displayed in license pickers""" - hidden: Boolean! - id: ID! + """User accounts on this Enterprise Server installation.""" + userAccounts( + """ + Ordering options for Enterprise Server user accounts returned from the connection. + """ + orderBy: EnterpriseServerUserAccountOrder = {field: LOGIN, direction: ASC} - """Instructions on how to implement the license""" - implementation: String + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The lowercased SPDX ID of the license""" - key: String! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The limitations set by the license""" - limitations: [LicenseRule]! + """Returns the first _n_ elements from the list.""" + first: Int - """The license full name specified by """ - name: String! + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterpriseServerUserAccountConnection! - """Customary short name if applicable (e.g, GPLv3)""" - nickname: String + """User accounts uploads for the Enterprise Server installation.""" + userAccountsUploads( + """ + Ordering options for Enterprise Server user accounts uploads returned from the connection. + """ + orderBy: EnterpriseServerUserAccountsUploadOrder = {field: CREATED_AT, direction: DESC} - """The permissions set by the license""" - permissions: [LicenseRule]! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """ - Whether the license is a pseudo-license placeholder (e.g., other, no-license) - """ - pseudoLicense: Boolean! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Short identifier specified by """ - spdxId: String + """Returns the first _n_ elements from the list.""" + first: Int - """URL to the license on """ - url: URI + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterpriseServerUserAccountsUploadConnection! } -"""Describes a License's conditions, permissions, and limitations""" -type LicenseRule { - """A description of the rule""" - description: String! +"""The connection type for EnterpriseServerInstallation.""" +type EnterpriseServerInstallationConnection { + """A list of edges.""" + edges: [EnterpriseServerInstallationEdge] - """The machine-readable rule key""" - key: String! + """A list of nodes.""" + nodes: [EnterpriseServerInstallation] - """The human-readable rule label""" - label: String! -} + """Information to aid in pagination.""" + pageInfo: PageInfo! -"""Autogenerated input type of LinkRepositoryToProject""" -input LinkRepositoryToProjectInput { - """The ID of the Project to link to a Repository""" - projectId: ID! + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """The ID of the Repository to link to a Project.""" - repositoryId: ID! +"""An edge in a connection.""" +type EnterpriseServerInstallationEdge { + """A cursor for use in pagination.""" + cursor: String! - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """The item at the end of the edge.""" + node: EnterpriseServerInstallation } -"""Autogenerated return type of LinkRepositoryToProject""" -type LinkRepositoryToProjectPayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String - - """The linked Project.""" - project: Project +"""Ordering options for Enterprise Server installation connections.""" +input EnterpriseServerInstallationOrder { + """The field to order Enterprise Server installations by.""" + field: EnterpriseServerInstallationOrderField! - """The linked Repository.""" - repository: Repository + """The ordering direction.""" + direction: OrderDirection! } -"""An object that can be locked.""" -interface Lockable { - """Reason that the conversation was locked.""" - activeLockReason: LockReason +""" +Properties by which Enterprise Server installation connections can be ordered. +""" +enum EnterpriseServerInstallationOrderField { + """Order Enterprise Server installations by host name""" + HOST_NAME - """`true` if the object is locked""" - locked: Boolean! -} + """Order Enterprise Server installations by customer name""" + CUSTOMER_NAME -"""Represents a 'locked' event on a given issue or pull request.""" -type LockedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + """Order Enterprise Server installations by creation time""" + CREATED_AT +} +"""A user account on an Enterprise Server installation.""" +type EnterpriseServerUserAccount implements Node { """Identifies the date and time when the object was created.""" createdAt: DateTime! - id: ID! - """Reason that the conversation was locked (optional).""" - lockReason: LockReason - - """Object that was locked.""" - lockable: Lockable! -} + """User emails belonging to this user account.""" + emails( + """ + Ordering options for Enterprise Server user account emails returned from the connection. + """ + orderBy: EnterpriseServerUserAccountEmailOrder = {field: EMAIL, direction: ASC} -"""Autogenerated input type of LockLockable""" -input LockLockableInput { - """ID of the issue or pull request to be locked.""" - lockableId: ID! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """A reason for why the issue or pull request will be locked.""" - lockReason: LockReason + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """Returns the first _n_ elements from the list.""" + first: Int -"""Autogenerated return type of LockLockable""" -type LockLockablePayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterpriseServerUserAccountEmailConnection! - """The item that was locked.""" - lockedRecord: Lockable -} + """The Enterprise Server installation on which this user account exists.""" + enterpriseServerInstallation: EnterpriseServerInstallation! + id: ID! -"""The possible reasons that an issue or pull request was locked.""" -enum LockReason { """ - The issue or pull request was locked because the conversation was off-topic. + Whether the user account is a site administrator on the Enterprise Server installation. """ - OFF_TOPIC + isSiteAdmin: Boolean! - """ - The issue or pull request was locked because the conversation was too heated. - """ - TOO_HEATED + """The login of the user account on the Enterprise Server installation.""" + login: String! """ - The issue or pull request was locked because the conversation was resolved. + The profile name of the user account on the Enterprise Server installation. """ - RESOLVED + profileName: String """ - The issue or pull request was locked because the conversation was spam. + The date and time when the user account was created on the Enterprise Server installation. """ - SPAM -} - -"""A placeholder user for attribution of imported data on GitHub.""" -type Mannequin implements Node & Actor & UniformResourceLocatable { - """A URL pointing to the GitHub App's public avatar.""" - avatarUrl( - """The size of the resulting square image.""" - size: Int - ): URI! + remoteCreatedAt: DateTime! - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """The ID of the user account on the Enterprise Server installation.""" + remoteUserId: Int! - """Identifies the primary key from the database.""" - databaseId: Int - id: ID! + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! +} - """The username of the actor.""" - login: String! +"""The connection type for EnterpriseServerUserAccount.""" +type EnterpriseServerUserAccountConnection { + """A list of edges.""" + edges: [EnterpriseServerUserAccountEdge] - """The HTML path to this resource.""" - resourcePath: URI! + """A list of nodes.""" + nodes: [EnterpriseServerUserAccount] - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """The URL to this resource.""" - url: URI! + """Identifies the total count of items in the connection.""" + totalCount: Int! } -""" -Represents a 'marked_as_duplicate' event on a given issue or pull request. -""" -type MarkedAsDuplicateEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor +"""An edge in a connection.""" +type EnterpriseServerUserAccountEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: EnterpriseServerUserAccount +} +""" +An email belonging to a user account on an Enterprise Server installation. +""" +type EnterpriseServerUserAccountEmail implements Node { """Identifies the date and time when the object was created.""" createdAt: DateTime! - id: ID! -} -"""A public description of a Marketplace category.""" -type MarketplaceCategory implements Node { - """The category's description.""" - description: String + """The email address.""" + email: String! + id: ID! """ - The technical description of how apps listed in this category work with GitHub. + Indicates whether this is the primary email of the associated user account. """ - howItWorks: String - id: ID! + isPrimary: Boolean! - """The category's name.""" - name: String! + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! - """How many Marketplace listings have this as their primary category.""" - primaryListingCount: Int! + """The user account to which the email belongs.""" + userAccount: EnterpriseServerUserAccount! +} - """The HTTP path for this Marketplace category.""" - resourcePath: URI! +"""The connection type for EnterpriseServerUserAccountEmail.""" +type EnterpriseServerUserAccountEmailConnection { + """A list of edges.""" + edges: [EnterpriseServerUserAccountEmailEdge] - """How many Marketplace listings have this as their secondary category.""" - secondaryListingCount: Int! + """A list of nodes.""" + nodes: [EnterpriseServerUserAccountEmail] - """The short name of the category used in its URL.""" - slug: String! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """The HTTP URL for this Marketplace category.""" - url: URI! + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""A listing in the GitHub integration marketplace.""" -type MarketplaceListing implements Node { - """The GitHub App this listing represents.""" - app: App - - """URL to the listing owner's company site.""" - companyUrl: URI +"""An edge in a connection.""" +type EnterpriseServerUserAccountEmailEdge { + """A cursor for use in pagination.""" + cursor: String! - """ - The HTTP path for configuring access to the listing's integration or OAuth app - """ - configurationResourcePath: URI! + """The item at the end of the edge.""" + node: EnterpriseServerUserAccountEmail +} - """ - The HTTP URL for configuring access to the listing's integration or OAuth app - """ - configurationUrl: URI! +"""Ordering options for Enterprise Server user account email connections.""" +input EnterpriseServerUserAccountEmailOrder { + """The field to order emails by.""" + field: EnterpriseServerUserAccountEmailOrderField! - """URL to the listing's documentation.""" - documentationUrl: URI + """The ordering direction.""" + direction: OrderDirection! +} - """The listing's detailed description.""" - extendedDescription: String +""" +Properties by which Enterprise Server user account email connections can be ordered. +""" +enum EnterpriseServerUserAccountEmailOrderField { + """Order emails by email""" + EMAIL +} - """The listing's detailed description rendered to HTML.""" - extendedDescriptionHTML: HTML! +"""Ordering options for Enterprise Server user account connections.""" +input EnterpriseServerUserAccountOrder { + """The field to order user accounts by.""" + field: EnterpriseServerUserAccountOrderField! - """The listing's introductory description.""" - fullDescription: String! + """The ordering direction.""" + direction: OrderDirection! +} - """The listing's introductory description rendered to HTML.""" - fullDescriptionHTML: HTML! +""" +Properties by which Enterprise Server user account connections can be ordered. +""" +enum EnterpriseServerUserAccountOrderField { + """Order user accounts by login""" + LOGIN - """Does this listing have any plans with a free trial?""" - hasPublishedFreeTrialPlans: Boolean! + """ + Order user accounts by creation time on the Enterprise Server installation + """ + REMOTE_CREATED_AT +} - """Does this listing have a terms of service link?""" - hasTermsOfService: Boolean! +"""A user accounts upload from an Enterprise Server installation.""" +type EnterpriseServerUserAccountsUpload implements Node { + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """A technical description of how this app works with GitHub.""" - howItWorks: String + """The enterprise to which this upload belongs.""" + enterprise: Enterprise! - """The listing's technical description rendered to HTML.""" - howItWorksHTML: HTML! + """ + The Enterprise Server installation for which this upload was generated. + """ + enterpriseServerInstallation: EnterpriseServerInstallation! id: ID! - """URL to install the product to the viewer's account or organization.""" - installationUrl: URI + """The name of the file uploaded.""" + name: String! - """Whether this listing's app has been installed for the current viewer""" - installedForViewer: Boolean! + """The synchronization state of the upload""" + syncState: EnterpriseServerUserAccountsUploadSyncState! - """Whether this listing has been removed from the Marketplace.""" - isArchived: Boolean! + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! +} - """ - Whether this listing is still an editable draft that has not been submitted - for review and is not publicly visible in the Marketplace. - """ - isDraft: Boolean! +"""The connection type for EnterpriseServerUserAccountsUpload.""" +type EnterpriseServerUserAccountsUploadConnection { + """A list of edges.""" + edges: [EnterpriseServerUserAccountsUploadEdge] - """ - Whether the product this listing represents is available as part of a paid plan. - """ - isPaid: Boolean! + """A list of nodes.""" + nodes: [EnterpriseServerUserAccountsUpload] - """Whether this listing has been approved for display in the Marketplace.""" - isPublic: Boolean! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """ - Whether this listing has been rejected by GitHub for display in the Marketplace. - """ - isRejected: Boolean! + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """ - Whether this listing has been approved for unverified display in the Marketplace. - """ - isUnverified: Boolean! +"""An edge in a connection.""" +type EnterpriseServerUserAccountsUploadEdge { + """A cursor for use in pagination.""" + cursor: String! - """ - Whether this draft listing has been submitted for review for approval to be unverified in the Marketplace. - """ - isUnverifiedPending: Boolean! + """The item at the end of the edge.""" + node: EnterpriseServerUserAccountsUpload +} - """ - Whether this draft listing has been submitted for review from GitHub for approval to be verified in the Marketplace. - """ - isVerificationPendingFromDraft: Boolean! +""" +Ordering options for Enterprise Server user accounts upload connections. +""" +input EnterpriseServerUserAccountsUploadOrder { + """The field to order user accounts uploads by.""" + field: EnterpriseServerUserAccountsUploadOrderField! - """ - Whether this unverified listing has been submitted for review from GitHub for approval to be verified in the Marketplace. - """ - isVerificationPendingFromUnverified: Boolean! + """The ordering direction.""" + direction: OrderDirection! +} - """ - Whether this listing has been approved for verified display in the Marketplace. - """ - isVerified: Boolean! +""" +Properties by which Enterprise Server user accounts upload connections can be ordered. +""" +enum EnterpriseServerUserAccountsUploadOrderField { + """Order user accounts uploads by creation time""" + CREATED_AT +} - """The hex color code, without the leading '#', for the logo background.""" - logoBackgroundColor: String! +"""Synchronization state of the Enterprise Server user accounts upload""" +enum EnterpriseServerUserAccountsUploadSyncState { + """The synchronization of the upload is pending.""" + PENDING - """URL for the listing's logo image.""" - logoUrl( - """The size in pixels of the resulting square image.""" - size: Int = 400 - ): URI + """The synchronization of the upload succeeded.""" + SUCCESS - """The listing's full name.""" - name: String! + """The synchronization of the upload failed.""" + FAILURE +} - """ - The listing's very short description without a trailing period or ampersands. - """ - normalizedShortDescription: String! +""" +An account for a user who is an admin of an enterprise or a member of an enterprise through one or more organizations. +""" +type EnterpriseUserAccount implements Node & Actor { + """A URL pointing to the enterprise user account's public avatar.""" + avatarUrl( + """The size of the resulting square image.""" + size: Int + ): URI! - """URL to the listing's detailed pricing.""" - pricingUrl: URI + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """The category that best describes the listing.""" - primaryCategory: MarketplaceCategory! + """The enterprise in which this user account exists.""" + enterprise: Enterprise! + id: ID! """ - URL to the listing's privacy policy, may return an empty string for listings that do not require a privacy policy URL. + An identifier for the enterprise user account, a login or email address """ - privacyPolicyUrl: URI! + login: String! - """The HTTP path for the Marketplace listing.""" - resourcePath: URI! + """The name of the enterprise user account""" + name: String - """The URLs for the listing's screenshots.""" - screenshotUrls: [String]! + """A list of enterprise organizations this user is a member of.""" + organizations( + """The search string to look for.""" + query: String - """An alternate category that describes the listing.""" - secondaryCategory: MarketplaceCategory + """Ordering options for organizations returned from the connection.""" + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC} - """The listing's very short description.""" - shortDescription: String! + """The role of the user in the enterprise organization.""" + role: EnterpriseUserAccountMembershipRole - """The short name of the listing used in its URL.""" - slug: String! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """URL to the listing's status page.""" - statusUrl: URI + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """An email address for support for this listing's app.""" - supportEmail: String + """Returns the first _n_ elements from the list.""" + first: Int - """ - Either a URL or an email address for support for this listing's app, may - return an empty string for listings that do not require a support URL. - """ - supportUrl: URI! + """Returns the last _n_ elements from the list.""" + last: Int + ): EnterpriseOrganizationMembershipConnection! - """URL to the listing's terms of service.""" - termsOfServiceUrl: URI + """The HTTP path for this actor.""" + resourcePath: URI! - """The HTTP URL for the Marketplace listing.""" + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + + """The HTTP URL for this actor.""" url: URI! - """Can the current viewer add plans for this Marketplace listing.""" - viewerCanAddPlans: Boolean! + """The user within the enterprise.""" + user: User +} - """Can the current viewer approve this Marketplace listing.""" - viewerCanApprove: Boolean! +"""The connection type for EnterpriseUserAccount.""" +type EnterpriseUserAccountConnection { + """A list of edges.""" + edges: [EnterpriseUserAccountEdge] - """Can the current viewer delist this Marketplace listing.""" - viewerCanDelist: Boolean! + """A list of nodes.""" + nodes: [EnterpriseUserAccount] - """Can the current viewer edit this Marketplace listing.""" - viewerCanEdit: Boolean! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """ - Can the current viewer edit the primary and secondary category of this - Marketplace listing. - - """ - viewerCanEditCategories: Boolean! + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """Can the current viewer edit the plans for this Marketplace listing.""" - viewerCanEditPlans: Boolean! +"""An edge in a connection.""" +type EnterpriseUserAccountEdge { + """A cursor for use in pagination.""" + cursor: String! - """ - Can the current viewer return this Marketplace listing to draft state - so it becomes editable again. - - """ - viewerCanRedraft: Boolean! + """The item at the end of the edge.""" + node: EnterpriseUserAccount +} - """ - Can the current viewer reject this Marketplace listing by returning it to - an editable draft state or rejecting it entirely. - - """ - viewerCanReject: Boolean! +"""The possible roles for enterprise membership.""" +enum EnterpriseUserAccountMembershipRole { + """The user is a member of the enterprise membership.""" + MEMBER - """ - Can the current viewer request this listing be reviewed for display in - the Marketplace as verified. - - """ - viewerCanRequestApproval: Boolean! + """The user is an owner of the enterprise membership.""" + OWNER +} - """ - Indicates whether the current user has an active subscription to this Marketplace listing. - - """ - viewerHasPurchased: Boolean! +"""The possible GitHub Enterprise deployments where this user can exist.""" +enum EnterpriseUserDeployment { + """The user is part of a GitHub Enterprise Cloud deployment.""" + CLOUD - """ - Indicates if the current user has purchased a subscription to this Marketplace listing - for all of the organizations the user owns. - - """ - viewerHasPurchasedForAllOrganizations: Boolean! + """The user is part of a GitHub Enterprise Server deployment.""" + SERVER +} + +"""An external identity provisioned by SAML SSO or SCIM.""" +type ExternalIdentity implements Node { + """The GUID for this identity""" + guid: String! + id: ID! + + """Organization invitation for this SCIM-provisioned external identity""" + organizationInvitation: OrganizationInvitation + + """SAML Identity attributes""" + samlIdentity: ExternalIdentitySamlAttributes + + """SCIM Identity attributes""" + scimIdentity: ExternalIdentityScimAttributes """ - Does the current viewer role allow them to administer this Marketplace listing. - + User linked to this external identity. Will be NULL if this identity has not been claimed by an organization member. """ - viewerIsListingAdmin: Boolean! + user: User } -"""Look up Marketplace Listings""" -type MarketplaceListingConnection { +"""The connection type for ExternalIdentity.""" +type ExternalIdentityConnection { """A list of edges.""" - edges: [MarketplaceListingEdge] + edges: [ExternalIdentityEdge] """A list of nodes.""" - nodes: [MarketplaceListing] + nodes: [ExternalIdentity] """Information to aid in pagination.""" pageInfo: PageInfo! @@ -6011,209 +5886,243 @@ type MarketplaceListingConnection { } """An edge in a connection.""" -type MarketplaceListingEdge { +type ExternalIdentityEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: MarketplaceListing + node: ExternalIdentity } -"""Audit log entry for a members_can_delete_repos.clear event.""" -type MembersCanDeleteReposClearAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { - """The action name""" - action: String! - - """The user who initiated the action""" - actor: AuditEntryActor - - """The IP address of the actor""" - actorIp: String +"""SAML attributes for the External Identity""" +type ExternalIdentitySamlAttributes { + """The NameID of the SAML identity""" + nameId: String +} - """A readable representation of the actor's location""" - actorLocation: ActorLocation +"""SCIM attributes for the External Identity""" +type ExternalIdentityScimAttributes { + """The userName of the SCIM identity""" + username: String +} - """The username of the user who initiated the action""" - actorLogin: String +"""The connection type for User.""" +type FollowerConnection { + """A list of edges.""" + edges: [UserEdge] - """The HTTP path for the actor.""" - actorResourcePath: URI + """A list of nodes.""" + nodes: [User] - """The HTTP URL for the actor.""" - actorUrl: URI + """Information to aid in pagination.""" + pageInfo: PageInfo! - """The time the action was initiated""" - createdAt: PreciseDateTime! + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """The HTTP path for this enterprise.""" - enterpriseResourcePath: URI +"""The connection type for User.""" +type FollowingConnection { + """A list of edges.""" + edges: [UserEdge] - """The slug of the enterprise.""" - enterpriseSlug: String + """A list of nodes.""" + nodes: [User] - """The HTTP URL for this enterprise.""" - enterpriseUrl: URI - id: ID! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """The Organization associated with the Audit Entry.""" - organization: Organization + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """The name of the Organization.""" - organizationName: String +"""Autogenerated input type of FollowUser""" +input FollowUserInput { + """ID of the user to follow.""" + userId: ID! - """The HTTP path for the organization""" - organizationResourcePath: URI + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} - """The HTTP URL for the organization""" - organizationUrl: URI +"""Autogenerated return type of FollowUser""" +type FollowUserPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String - """The user affected by the action""" + """The user that was followed.""" user: User +} - """ - For actions involving two users, the actor is the initiator and the user is the affected user. - """ - userLogin: String - - """The HTTP path for the user.""" - userResourcePath: URI +"""A generic hovercard context with a message and icon""" +type GenericHovercardContext implements HovercardContext { + """A string describing this context""" + message: String! - """The HTTP URL for the user.""" - userUrl: URI + """An octicon to accompany this context""" + octicon: String! } -"""Audit log entry for a members_can_delete_repos.disable event.""" -type MembersCanDeleteReposDisableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { - """The action name""" - action: String! +"""A Gist.""" +type Gist implements Node & Starrable & UniformResourceLocatable { + """A list of comments associated with the gist""" + comments( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The user who initiated the action""" - actor: AuditEntryActor + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The IP address of the actor""" - actorIp: String + """Returns the first _n_ elements from the list.""" + first: Int - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """Returns the last _n_ elements from the list.""" + last: Int + ): GistCommentConnection! - """The username of the user who initiated the action""" - actorLogin: String + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """The HTTP path for the actor.""" - actorResourcePath: URI + """The gist description.""" + description: String - """The HTTP URL for the actor.""" - actorUrl: URI + """The files in this gist.""" + files( + """The maximum number of files to return.""" + limit: Int = 10 - """The time the action was initiated""" - createdAt: PreciseDateTime! + """The oid of the files to return""" + oid: GitObjectID + ): [GistFile] - """The HTTP path for this enterprise.""" - enterpriseResourcePath: URI + """A list of forks associated with the gist""" + forks( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The slug of the enterprise.""" - enterpriseSlug: String + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The HTTP URL for this enterprise.""" - enterpriseUrl: URI - id: ID! + """Returns the first _n_ elements from the list.""" + first: Int - """The Organization associated with the Audit Entry.""" - organization: Organization + """Returns the last _n_ elements from the list.""" + last: Int - """The name of the Organization.""" - organizationName: String + """Ordering options for gists returned from the connection""" + orderBy: GistOrder + ): GistConnection! + id: ID! - """The HTTP path for the organization""" - organizationResourcePath: URI + """Identifies if the gist is a fork.""" + isFork: Boolean! - """The HTTP URL for the organization""" - organizationUrl: URI + """Whether the gist is public or not.""" + isPublic: Boolean! - """The user affected by the action""" - user: User + """The gist name.""" + name: String! - """ - For actions involving two users, the actor is the initiator and the user is the affected user. - """ - userLogin: String + """The gist owner.""" + owner: RepositoryOwner - """The HTTP path for the user.""" - userResourcePath: URI + """Identifies when the gist was last pushed to.""" + pushedAt: DateTime - """The HTTP URL for the user.""" - userUrl: URI -} + """The HTML path to this resource.""" + resourcePath: URI! -"""Audit log entry for a members_can_delete_repos.enable event.""" -type MembersCanDeleteReposEnableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { - """The action name""" - action: String! + """A list of users who have starred this starrable.""" + stargazers( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The user who initiated the action""" - actor: AuditEntryActor + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The IP address of the actor""" - actorIp: String + """Returns the first _n_ elements from the list.""" + first: Int - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """Returns the last _n_ elements from the list.""" + last: Int - """The username of the user who initiated the action""" - actorLogin: String + """Order for connection""" + orderBy: StarOrder + ): StargazerConnection! - """The HTTP path for the actor.""" - actorResourcePath: URI + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! - """The HTTP URL for the actor.""" - actorUrl: URI + """The HTTP URL for this Gist.""" + url: URI! - """The time the action was initiated""" - createdAt: PreciseDateTime! + """ + Returns a boolean indicating whether the viewing user has starred this starrable. + """ + viewerHasStarred: Boolean! +} - """The HTTP path for this enterprise.""" - enterpriseResourcePath: URI +"""Represents a comment on an Gist.""" +type GistComment implements Node & Comment & Deletable & Updatable & UpdatableComment { + """The actor who authored the comment.""" + author: Actor - """The slug of the enterprise.""" - enterpriseSlug: String + """Author's association with the gist.""" + authorAssociation: CommentAuthorAssociation! - """The HTTP URL for this enterprise.""" - enterpriseUrl: URI - id: ID! + """Identifies the comment body.""" + body: String! - """The Organization associated with the Audit Entry.""" - organization: Organization + """The body rendered to HTML.""" + bodyHTML: HTML! - """The name of the Organization.""" - organizationName: String + """The body rendered to text.""" + bodyText: String! - """The HTTP path for the organization""" - organizationResourcePath: URI + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """The HTTP URL for the organization""" - organizationUrl: URI + """Check if this comment was created via an email reply.""" + createdViaEmail: Boolean! - """The user affected by the action""" - user: User + """Identifies the primary key from the database.""" + databaseId: Int + + """The actor who edited the comment.""" + editor: Actor + + """The associated gist.""" + gist: Gist! + id: ID! """ - For actions involving two users, the actor is the initiator and the user is the affected user. + Check if this comment was edited and includes an edit with the creation data """ - userLogin: String + includesCreatedEdit: Boolean! - """The HTTP path for the user.""" - userResourcePath: URI + """Returns whether or not a comment has been minimized.""" + isMinimized: Boolean! - """The HTTP URL for the user.""" - userUrl: URI -} + """The moment the editor made the last edit""" + lastEditedAt: DateTime -"""Entities that have members who can set status messages.""" -interface MemberStatusable { - """ - Get the status messages members of this entity have set that are either public or visible only to the organization. - """ - memberStatuses( + """Returns why the comment was minimized.""" + minimizedReason: String + + """Identifies when the comment was published at.""" + publishedAt: DateTime + + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + + """A list of edits to this content.""" + userContentEdits( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -6227,102 +6136,2213 @@ interface MemberStatusable { """Returns the last _n_ elements from the list.""" last: Int + ): UserContentEditConnection - """Ordering options for user statuses returned from the connection.""" - orderBy: UserStatusOrder - ): UserStatusConnection! -} + """Check if the current viewer can delete this object.""" + viewerCanDelete: Boolean! -"""Represents a 'mentioned' event on a given issue or pull request.""" -type MentionedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + """Check if the current viewer can minimize this object.""" + viewerCanMinimize: Boolean! - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """Check if the current viewer can update this object.""" + viewerCanUpdate: Boolean! - """Identifies the primary key from the database.""" - databaseId: Int - id: ID! + """Reasons why the current viewer can not update this comment.""" + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + + """Did the viewer author this comment.""" + viewerDidAuthor: Boolean! } -"""Whether or not a PullRequest can be merged.""" -enum MergeableState { - """The pull request can be merged.""" - MERGEABLE +"""The connection type for GistComment.""" +type GistCommentConnection { + """A list of edges.""" + edges: [GistCommentEdge] - """The pull request cannot be merged due to merge conflicts.""" - CONFLICTING + """A list of nodes.""" + nodes: [GistComment] - """The mergeability of the pull request is still being calculated.""" - UNKNOWN + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""Autogenerated input type of MergeBranch""" -input MergeBranchInput { - """ - The Node ID of the Repository containing the base branch that will be modified. - """ - repositoryId: ID! +"""An edge in a connection.""" +type GistCommentEdge { + """A cursor for use in pagination.""" + cursor: String! - """ - The name of the base branch that the provided head will be merged into. - """ - base: String! + """The item at the end of the edge.""" + node: GistComment +} - """ - The head to merge into the base branch. This can be a branch name or a commit GitObjectID. - """ - head: String! +"""The connection type for Gist.""" +type GistConnection { + """A list of edges.""" + edges: [GistEdge] - """ - Message to use for the merge commit. If omitted, a default will be used. - """ - commitMessage: String + """A list of nodes.""" + nodes: [Gist] - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""Autogenerated return type of MergeBranch""" -type MergeBranchPayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String +"""An edge in a connection.""" +type GistEdge { + """A cursor for use in pagination.""" + cursor: String! - """The resulting merge Commit.""" - mergeCommit: Commit + """The item at the end of the edge.""" + node: Gist } -"""Represents a 'merged' event on a given pull request.""" -type MergedEvent implements Node & UniformResourceLocatable { - """Identifies the actor who performed the event.""" - actor: Actor +"""A file in a gist.""" +type GistFile { + """ + The file name encoded to remove characters that are invalid in URL paths. + """ + encodedName: String - """Identifies the commit associated with the `merge` event.""" - commit: Commit + """The gist file encoding.""" + encoding: String - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! + """The file extension from the file name.""" + extension: String - """Identifies the Ref associated with the `merge` event.""" - mergeRef: Ref + """Indicates if this file is an image.""" + isImage: Boolean! - """Identifies the name of the Ref associated with the `merge` event.""" - mergeRefName: String! + """Whether the file's contents were truncated.""" + isTruncated: Boolean! - """PullRequest referenced by event.""" - pullRequest: PullRequest! + """The programming language this file is written in.""" + language: Language - """The HTTP path for this merged event.""" - resourcePath: URI! + """The gist file name.""" + name: String - """The HTTP URL for this merged event.""" - url: URI! -} + """The gist file size in bytes.""" + size: Int -"""Autogenerated input type of MergePullRequest""" -input MergePullRequestInput { + """UTF8 text data or null if the file is binary""" + text( + """Optionally truncate the returned file to this length.""" + truncate: Int + ): String +} + +"""Ordering options for gist connections""" +input GistOrder { + """The field to order repositories by.""" + field: GistOrderField! + + """The ordering direction.""" + direction: OrderDirection! +} + +"""Properties by which gist connections can be ordered.""" +enum GistOrderField { + """Order gists by creation time""" + CREATED_AT + + """Order gists by update time""" + UPDATED_AT + + """Order gists by push time""" + PUSHED_AT +} + +"""The privacy of a Gist""" +enum GistPrivacy { + """Public""" + PUBLIC + + """Secret""" + SECRET + + """Gists that are public and secret""" + ALL +} + +"""Represents an actor in a Git commit (ie. an author or committer).""" +type GitActor { + """A URL pointing to the author's public avatar.""" + avatarUrl( + """The size of the resulting square image.""" + size: Int + ): URI! + + """The timestamp of the Git action (authoring or committing).""" + date: GitTimestamp + + """The email in the Git commit.""" + email: String + + """The name in the Git commit.""" + name: String + + """ + The GitHub user corresponding to the email field. Null if no such user exists. + """ + user: User +} + +"""Represents information about the GitHub instance.""" +type GitHubMetadata { + """Returns a String that's a SHA of `github-services`""" + gitHubServicesSha: GitObjectID! + + """IP addresses that users connect to for git operations""" + gitIpAddresses: [String!] + + """IP addresses that service hooks are sent from""" + hookIpAddresses: [String!] + + """IP addresses that the importer connects from""" + importerIpAddresses: [String!] + + """Whether or not users are verified""" + isPasswordAuthenticationVerifiable: Boolean! + + """IP addresses for GitHub Pages' A records""" + pagesIpAddresses: [String!] +} + +"""Represents a Git object.""" +interface GitObject { + """An abbreviated version of the Git object ID""" + abbreviatedOid: String! + + """The HTTP path for this Git object""" + commitResourcePath: URI! + + """The HTTP URL for this Git object""" + commitUrl: URI! + id: ID! + + """The Git object ID""" + oid: GitObjectID! + + """The Repository the Git object belongs to""" + repository: Repository! +} + +"""A Git object ID.""" +scalar GitObjectID + +"""Information about a signature (GPG or S/MIME) on a Commit or Tag.""" +interface GitSignature { + """Email used to sign this object.""" + email: String! + + """True if the signature is valid and verified by GitHub.""" + isValid: Boolean! + + """ + Payload for GPG signing object. Raw ODB object without the signature header. + """ + payload: String! + + """ASCII-armored signature header from object.""" + signature: String! + + """GitHub user corresponding to the email signing this commit.""" + signer: User + + """ + The state of this signature. `VALID` if signature is valid and verified by + GitHub, otherwise represents reason why signature is considered invalid. + """ + state: GitSignatureState! + + """True if the signature was made with GitHub's signing key.""" + wasSignedByGitHub: Boolean! +} + +"""The state of a Git signature.""" +enum GitSignatureState { + """Valid signature and verified by GitHub""" + VALID + + """Invalid signature""" + INVALID + + """Malformed signature""" + MALFORMED_SIG + + """Key used for signing not known to GitHub""" + UNKNOWN_KEY + + """Invalid email used for signing""" + BAD_EMAIL + + """Email used for signing unverified on GitHub""" + UNVERIFIED_EMAIL + + """Email used for signing not known to GitHub""" + NO_USER + + """Unknown signature type""" + UNKNOWN_SIG_TYPE + + """Unsigned""" + UNSIGNED + + """ + Internal error - the GPG verification service is unavailable at the moment + """ + GPGVERIFY_UNAVAILABLE + + """Internal error - the GPG verification service misbehaved""" + GPGVERIFY_ERROR + + """The usage flags for the key that signed this don't allow signing""" + NOT_SIGNING_KEY + + """Signing key expired""" + EXPIRED_KEY + + """Valid signature, pending certificate revocation checking""" + OCSP_PENDING + + """Valid siganture, though certificate revocation check failed""" + OCSP_ERROR + + """The signing certificate or its chain could not be verified""" + BAD_CERT + + """One or more certificates in chain has been revoked""" + OCSP_REVOKED +} + +"""Git SSH string""" +scalar GitSSHRemote + +""" +An ISO-8601 encoded date string. Unlike the DateTime type, GitTimestamp is not converted in UTC. +""" +scalar GitTimestamp + +"""Represents a GPG signature on a Commit or Tag.""" +type GpgSignature implements GitSignature { + """Email used to sign this object.""" + email: String! + + """True if the signature is valid and verified by GitHub.""" + isValid: Boolean! + + """Hex-encoded ID of the key that signed this object.""" + keyId: String + + """ + Payload for GPG signing object. Raw ODB object without the signature header. + """ + payload: String! + + """ASCII-armored signature header from object.""" + signature: String! + + """GitHub user corresponding to the email signing this commit.""" + signer: User + + """ + The state of this signature. `VALID` if signature is valid and verified by + GitHub, otherwise represents reason why signature is considered invalid. + """ + state: GitSignatureState! + + """True if the signature was made with GitHub's signing key.""" + wasSignedByGitHub: Boolean! +} + +"""Represents a 'head_ref_deleted' event on a given pull request.""" +type HeadRefDeletedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """Identifies the Ref associated with the `head_ref_deleted` event.""" + headRef: Ref + + """ + Identifies the name of the Ref associated with the `head_ref_deleted` event. + """ + headRefName: String! + id: ID! + + """PullRequest referenced by event.""" + pullRequest: PullRequest! +} + +"""Represents a 'head_ref_force_pushed' event on a given pull request.""" +type HeadRefForcePushedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the after commit SHA for the 'head_ref_force_pushed' event.""" + afterCommit: Commit + + """ + Identifies the before commit SHA for the 'head_ref_force_pushed' event. + """ + beforeCommit: Commit + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! + + """PullRequest referenced by event.""" + pullRequest: PullRequest! + + """ + Identifies the fully qualified ref name for the 'head_ref_force_pushed' event. + """ + ref: Ref +} + +"""Represents a 'head_ref_restored' event on a given pull request.""" +type HeadRefRestoredEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! + + """PullRequest referenced by event.""" + pullRequest: PullRequest! +} + +"""Detail needed to display a hovercard for a user""" +type Hovercard { + """Each of the contexts for this hovercard""" + contexts: [HovercardContext!]! +} + +"""An individual line of a hovercard""" +interface HovercardContext { + """A string describing this context""" + message: String! + + """An octicon to accompany this context""" + octicon: String! +} + +"""A string containing HTML code.""" +scalar HTML + +""" +The possible states in which authentication can be configured with an identity provider. +""" +enum IdentityProviderConfigurationState { + """Authentication with an identity provider is configured and enforced.""" + ENFORCED + + """ + Authentication with an identity provider is configured but not enforced. + """ + CONFIGURED + + """Authentication with an identity provider is not configured.""" + UNCONFIGURED +} + +"""Autogenerated input type of ImportProject""" +input ImportProjectInput { + """The name of the Organization or User to create the Project under.""" + ownerName: String! + + """The name of Project.""" + name: String! + + """The description of Project.""" + body: String + + """Whether the Project is public or not.""" + public: Boolean = false + + """A list of columns containing issues and pull requests.""" + columnImports: [ProjectColumnImport!]! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated input type of InviteEnterpriseAdmin""" +input InviteEnterpriseAdminInput { + """The ID of the enterprise to which you want to invite an administrator.""" + enterpriseId: ID! + + """The login of a user to invite as an administrator.""" + invitee: String + + """The email of the person to invite as an administrator.""" + email: String + + """The role of the administrator.""" + role: EnterpriseAdministratorRole + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of InviteEnterpriseAdmin""" +type InviteEnterpriseAdminPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The created enterprise administrator invitation.""" + invitation: EnterpriseAdministratorInvitation +} + +""" +An Issue is a place to discuss ideas, enhancements, tasks, and bugs for a project. +""" +type Issue implements Node & Assignable & Closable & Comment & Updatable & UpdatableComment & Labelable & Lockable & Reactable & RepositoryNode & Subscribable & UniformResourceLocatable { + """Reason that the conversation was locked.""" + activeLockReason: LockReason + + """A list of Users assigned to this object.""" + assignees( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): UserConnection! + + """The actor who authored the comment.""" + author: Actor + + """Author's association with the subject of the comment.""" + authorAssociation: CommentAuthorAssociation! + + """Identifies the body of the issue.""" + body: String! + + """The body rendered to HTML.""" + bodyHTML: HTML! + + """Identifies the body of the issue rendered to text.""" + bodyText: String! + + """ + `true` if the object is closed (definition of closed may depend on type) + """ + closed: Boolean! + + """Identifies the date and time when the object was closed.""" + closedAt: DateTime + + """A list of comments associated with the Issue.""" + comments( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): IssueCommentConnection! + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """Check if this comment was created via an email reply.""" + createdViaEmail: Boolean! + + """Identifies the primary key from the database.""" + databaseId: Int + + """The actor who edited the comment.""" + editor: Actor + + """The hovercard information for this issue""" + hovercard( + """Whether or not to include notification contexts""" + includeNotificationContexts: Boolean = true + ): Hovercard! + id: ID! + + """ + Check if this comment was edited and includes an edit with the creation data + """ + includesCreatedEdit: Boolean! + + """A list of labels associated with the object.""" + labels( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): LabelConnection + + """The moment the editor made the last edit""" + lastEditedAt: DateTime + + """`true` if the object is locked""" + locked: Boolean! + + """Identifies the milestone associated with the issue.""" + milestone: Milestone + + """Identifies the issue number.""" + number: Int! + + """A list of Users that are participating in the Issue conversation.""" + participants( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): UserConnection! + + """List of project cards associated with this issue.""" + projectCards( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + + """A list of archived states to filter the cards by""" + archivedStates: [ProjectCardArchivedState] = [ARCHIVED, NOT_ARCHIVED] + ): ProjectCardConnection! + + """Identifies when the comment was published at.""" + publishedAt: DateTime + + """A list of reactions grouped by content left on the subject.""" + reactionGroups: [ReactionGroup!] + + """A list of Reactions left on the Issue.""" + reactions( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + + """Allows filtering Reactions by emoji.""" + content: ReactionContent + + """Allows specifying the order in which reactions are returned.""" + orderBy: ReactionOrder + ): ReactionConnection! + + """The repository associated with this node.""" + repository: Repository! + + """The HTTP path for this issue""" + resourcePath: URI! + + """Identifies the state of the issue.""" + state: IssueState! + + """A list of events, comments, commits, etc. associated with the issue.""" + timelineItems( + """Filter timeline items by a `since` timestamp.""" + since: DateTime + + """Skips the first _n_ elements in the list.""" + skip: Int + + """Filter timeline items by type.""" + itemTypes: [IssueTimelineItemsItemType!] + + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): IssueTimelineItemsConnection! + + """Identifies the issue title.""" + title: String! + + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + + """The HTTP URL for this issue""" + url: URI! + + """A list of edits to this content.""" + userContentEdits( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): UserContentEditConnection + + """Can user react to this subject""" + viewerCanReact: Boolean! + + """ + Check if the viewer is able to change their subscription status for the repository. + """ + viewerCanSubscribe: Boolean! + + """Check if the current viewer can update this object.""" + viewerCanUpdate: Boolean! + + """Reasons why the current viewer can not update this comment.""" + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + + """Did the viewer author this comment.""" + viewerDidAuthor: Boolean! + + """ + Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. + """ + viewerSubscription: SubscriptionState +} + +"""Represents a comment on an Issue.""" +type IssueComment implements Node & Comment & Deletable & Updatable & UpdatableComment & Reactable & RepositoryNode { + """The actor who authored the comment.""" + author: Actor + + """Author's association with the subject of the comment.""" + authorAssociation: CommentAuthorAssociation! + + """The body as Markdown.""" + body: String! + + """The body rendered to HTML.""" + bodyHTML: HTML! + + """The body rendered to text.""" + bodyText: String! + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """Check if this comment was created via an email reply.""" + createdViaEmail: Boolean! + + """Identifies the primary key from the database.""" + databaseId: Int + + """The actor who edited the comment.""" + editor: Actor + id: ID! + + """ + Check if this comment was edited and includes an edit with the creation data + """ + includesCreatedEdit: Boolean! + + """Returns whether or not a comment has been minimized.""" + isMinimized: Boolean! + + """Identifies the issue associated with the comment.""" + issue: Issue! + + """The moment the editor made the last edit""" + lastEditedAt: DateTime + + """Returns why the comment was minimized.""" + minimizedReason: String + + """Identifies when the comment was published at.""" + publishedAt: DateTime + + """ + Returns the pull request associated with the comment, if this comment was made on a + pull request. + + """ + pullRequest: PullRequest + + """A list of reactions grouped by content left on the subject.""" + reactionGroups: [ReactionGroup!] + + """A list of Reactions left on the Issue.""" + reactions( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + + """Allows filtering Reactions by emoji.""" + content: ReactionContent + + """Allows specifying the order in which reactions are returned.""" + orderBy: ReactionOrder + ): ReactionConnection! + + """The repository associated with this node.""" + repository: Repository! + + """The HTTP path for this issue comment""" + resourcePath: URI! + + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + + """The HTTP URL for this issue comment""" + url: URI! + + """A list of edits to this content.""" + userContentEdits( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): UserContentEditConnection + + """Check if the current viewer can delete this object.""" + viewerCanDelete: Boolean! + + """Check if the current viewer can minimize this object.""" + viewerCanMinimize: Boolean! + + """Can user react to this subject""" + viewerCanReact: Boolean! + + """Check if the current viewer can update this object.""" + viewerCanUpdate: Boolean! + + """Reasons why the current viewer can not update this comment.""" + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + + """Did the viewer author this comment.""" + viewerDidAuthor: Boolean! +} + +"""The connection type for IssueComment.""" +type IssueCommentConnection { + """A list of edges.""" + edges: [IssueCommentEdge] + + """A list of nodes.""" + nodes: [IssueComment] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""An edge in a connection.""" +type IssueCommentEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: IssueComment +} + +"""The connection type for Issue.""" +type IssueConnection { + """A list of edges.""" + edges: [IssueEdge] + + """A list of nodes.""" + nodes: [Issue] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""This aggregates issues opened by a user within one repository.""" +type IssueContributionsByRepository { + """The issue contributions.""" + contributions( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + + """Ordering options for contributions returned from the connection.""" + orderBy: ContributionOrder = {field: OCCURRED_AT, direction: DESC} + ): CreatedIssueContributionConnection! + + """The repository in which the issues were opened.""" + repository: Repository! +} + +"""An edge in a connection.""" +type IssueEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: Issue +} + +"""Ways in which to filter lists of issues.""" +input IssueFilters { + """ + List issues assigned to given name. Pass in `null` for issues with no assigned + user, and `*` for issues assigned to any user. + """ + assignee: String + + """List issues created by given name.""" + createdBy: String + + """List issues where the list of label names exist on the issue.""" + labels: [String!] + + """List issues where the given name is mentioned in the issue.""" + mentioned: String + + """ + List issues by given milestone argument. If an string representation of an + integer is passed, it should refer to a milestone by its number field. Pass in + `null` for issues with no milestone, and `*` for issues that are assigned to any milestone. + """ + milestone: String + + """List issues that have been updated at or after the given date.""" + since: DateTime + + """List issues filtered by the list of states given.""" + states: [IssueState!] + + """List issues subscribed to by viewer.""" + viewerSubscribed: Boolean = false +} + +"""Ways in which lists of issues can be ordered upon return.""" +input IssueOrder { + """The field in which to order issues by.""" + field: IssueOrderField! + + """The direction in which to order issues by the specified field.""" + direction: OrderDirection! +} + +"""Properties by which issue connections can be ordered.""" +enum IssueOrderField { + """Order issues by creation time""" + CREATED_AT + + """Order issues by update time""" + UPDATED_AT + + """Order issues by comment count""" + COMMENTS +} + +"""Used for return value of Repository.issueOrPullRequest.""" +union IssueOrPullRequest = Issue | PullRequest + +"""An edge in a connection.""" +type IssueOrPullRequestEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: IssueOrPullRequest +} + +"""The possible PubSub channels for an issue.""" +enum IssuePubSubTopic { + """The channel ID for observing issue updates.""" + UPDATED + + """The channel ID for marking an issue as read.""" + MARKASREAD + + """The channel ID for updating items on the issue timeline.""" + TIMELINE + + """The channel ID for observing issue state updates.""" + STATE +} + +"""The possible states of an issue.""" +enum IssueState { + """An issue that is still open""" + OPEN + + """An issue that has been closed""" + CLOSED +} + +"""The connection type for IssueTimelineItem.""" +type IssueTimelineConnection { + """A list of edges.""" + edges: [IssueTimelineItemEdge] + + """A list of nodes.""" + nodes: [IssueTimelineItem] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""An item in an issue timeline""" +union IssueTimelineItem = Commit | IssueComment | CrossReferencedEvent | ClosedEvent | ReopenedEvent | SubscribedEvent | UnsubscribedEvent | ReferencedEvent | AssignedEvent | UnassignedEvent | LabeledEvent | UnlabeledEvent | UserBlockedEvent | MilestonedEvent | DemilestonedEvent | RenamedTitleEvent | LockedEvent | UnlockedEvent | TransferredEvent + +"""An edge in a connection.""" +type IssueTimelineItemEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: IssueTimelineItem +} + +"""An item in an issue timeline""" +union IssueTimelineItems = IssueComment | CrossReferencedEvent | AddedToProjectEvent | AssignedEvent | ClosedEvent | CommentDeletedEvent | ConvertedNoteToIssueEvent | DemilestonedEvent | LabeledEvent | LockedEvent | MarkedAsDuplicateEvent | MentionedEvent | MilestonedEvent | MovedColumnsInProjectEvent | PinnedEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UserBlockedEvent | UnpinnedEvent | UnsubscribedEvent + +"""The connection type for IssueTimelineItems.""" +type IssueTimelineItemsConnection { + """A list of edges.""" + edges: [IssueTimelineItemsEdge] + + """ + Identifies the count of items after applying `before` and `after` filters. + """ + filteredCount: Int! + + """A list of nodes.""" + nodes: [IssueTimelineItems] + + """ + Identifies the count of items after applying `before`/`after` filters and `first`/`last`/`skip` slicing. + """ + pageCount: Int! + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! + + """Identifies the date and time when the timeline was last updated.""" + updatedAt: DateTime! +} + +"""An edge in a connection.""" +type IssueTimelineItemsEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: IssueTimelineItems +} + +"""The possible item types found in a timeline.""" +enum IssueTimelineItemsItemType { + """Represents a comment on an Issue.""" + ISSUE_COMMENT + + """Represents a mention made by one issue or pull request to another.""" + CROSS_REFERENCED_EVENT + + """ + Represents a 'added_to_project' event on a given issue or pull request. + """ + ADDED_TO_PROJECT_EVENT + + """Represents an 'assigned' event on any assignable object.""" + ASSIGNED_EVENT + + """Represents a 'closed' event on any `Closable`.""" + CLOSED_EVENT + + """Represents a 'comment_deleted' event on a given issue or pull request.""" + COMMENT_DELETED_EVENT + + """ + Represents a 'converted_note_to_issue' event on a given issue or pull request. + """ + CONVERTED_NOTE_TO_ISSUE_EVENT + + """Represents a 'demilestoned' event on a given issue or pull request.""" + DEMILESTONED_EVENT + + """Represents a 'labeled' event on a given issue or pull request.""" + LABELED_EVENT + + """Represents a 'locked' event on a given issue or pull request.""" + LOCKED_EVENT + + """ + Represents a 'marked_as_duplicate' event on a given issue or pull request. + """ + MARKED_AS_DUPLICATE_EVENT + + """Represents a 'mentioned' event on a given issue or pull request.""" + MENTIONED_EVENT + + """Represents a 'milestoned' event on a given issue or pull request.""" + MILESTONED_EVENT + + """ + Represents a 'moved_columns_in_project' event on a given issue or pull request. + """ + MOVED_COLUMNS_IN_PROJECT_EVENT + + """Represents a 'pinned' event on a given issue or pull request.""" + PINNED_EVENT + + """Represents a 'referenced' event on a given `ReferencedSubject`.""" + REFERENCED_EVENT + + """ + Represents a 'removed_from_project' event on a given issue or pull request. + """ + REMOVED_FROM_PROJECT_EVENT + + """Represents a 'renamed' event on a given issue or pull request""" + RENAMED_TITLE_EVENT + + """Represents a 'reopened' event on any `Closable`.""" + REOPENED_EVENT + + """Represents a 'subscribed' event on a given `Subscribable`.""" + SUBSCRIBED_EVENT + + """Represents a 'transferred' event on a given issue or pull request.""" + TRANSFERRED_EVENT + + """Represents an 'unassigned' event on any assignable object.""" + UNASSIGNED_EVENT + + """Represents an 'unlabeled' event on a given issue or pull request.""" + UNLABELED_EVENT + + """Represents an 'unlocked' event on a given issue or pull request.""" + UNLOCKED_EVENT + + """Represents a 'user_blocked' event on a given user.""" + USER_BLOCKED_EVENT + + """Represents an 'unpinned' event on a given issue or pull request.""" + UNPINNED_EVENT + + """Represents an 'unsubscribed' event on a given `Subscribable`.""" + UNSUBSCRIBED_EVENT +} + +"""Represents a user signing up for a GitHub account.""" +type JoinedGitHubContribution implements Contribution { + """ + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + + """ + isRestricted: Boolean! + + """When this contribution was made.""" + occurredAt: DateTime! + + """The HTTP path for this contribution.""" + resourcePath: URI! + + """The HTTP URL for this contribution.""" + url: URI! + + """ + The user who made this contribution. + + """ + user: User! +} + +"""A label for categorizing Issues or Milestones with a given Repository.""" +type Label implements Node { + """Identifies the label color.""" + color: String! + + """Identifies the date and time when the label was created.""" + createdAt: DateTime + + """A brief description of this label.""" + description: String + id: ID! + + """Indicates whether or not this is a default label.""" + isDefault: Boolean! + + """A list of issues associated with this label.""" + issues( + """Ordering options for issues returned from the connection.""" + orderBy: IssueOrder + + """A list of label names to filter the pull requests by.""" + labels: [String!] + + """A list of states to filter the issues by.""" + states: [IssueState!] + + """Filtering options for issues returned from the connection.""" + filterBy: IssueFilters + + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): IssueConnection! + + """Identifies the label name.""" + name: String! + + """A list of pull requests associated with this label.""" + pullRequests( + """A list of states to filter the pull requests by.""" + states: [PullRequestState!] + + """A list of label names to filter the pull requests by.""" + labels: [String!] + + """The head ref name to filter the pull requests by.""" + headRefName: String + + """The base ref name to filter the pull requests by.""" + baseRefName: String + + """Ordering options for pull requests returned from the connection.""" + orderBy: IssueOrder + + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): PullRequestConnection! + + """The repository associated with this label.""" + repository: Repository! + + """The HTTP path for this label.""" + resourcePath: URI! + + """Identifies the date and time when the label was last updated.""" + updatedAt: DateTime + + """The HTTP URL for this label.""" + url: URI! +} + +"""An object that can have labels assigned to it.""" +interface Labelable { + """A list of labels associated with the object.""" + labels( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): LabelConnection +} + +"""The connection type for Label.""" +type LabelConnection { + """A list of edges.""" + edges: [LabelEdge] + + """A list of nodes.""" + nodes: [Label] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""Represents a 'labeled' event on a given issue or pull request.""" +type LabeledEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! + + """Identifies the label associated with the 'labeled' event.""" + label: Label! + + """Identifies the `Labelable` associated with the event.""" + labelable: Labelable! +} + +"""An edge in a connection.""" +type LabelEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: Label +} + +"""Represents a given language found in repositories.""" +type Language implements Node { + """The color defined for the current language.""" + color: String + id: ID! + + """The name of the current language.""" + name: String! +} + +"""A list of languages associated with the parent.""" +type LanguageConnection { + """A list of edges.""" + edges: [LanguageEdge] + + """A list of nodes.""" + nodes: [Language] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! + + """The total size in bytes of files written in that language.""" + totalSize: Int! +} + +"""Represents the language of a repository.""" +type LanguageEdge { + cursor: String! + node: Language! + + """The number of bytes of code written in the language.""" + size: Int! +} + +"""Ordering options for language connections.""" +input LanguageOrder { + """The field to order languages by.""" + field: LanguageOrderField! + + """The ordering direction.""" + direction: OrderDirection! +} + +"""Properties by which language connections can be ordered.""" +enum LanguageOrderField { + """Order languages by the size of all files containing the language""" + SIZE +} + +"""A repository's open source license""" +type License implements Node { + """The full text of the license""" + body: String! + + """The conditions set by the license""" + conditions: [LicenseRule]! + + """A human-readable description of the license""" + description: String + + """Whether the license should be featured""" + featured: Boolean! + + """Whether the license should be displayed in license pickers""" + hidden: Boolean! + id: ID! + + """Instructions on how to implement the license""" + implementation: String + + """The lowercased SPDX ID of the license""" + key: String! + + """The limitations set by the license""" + limitations: [LicenseRule]! + + """The license full name specified by """ + name: String! + + """Customary short name if applicable (e.g, GPLv3)""" + nickname: String + + """The permissions set by the license""" + permissions: [LicenseRule]! + + """ + Whether the license is a pseudo-license placeholder (e.g., other, no-license) + """ + pseudoLicense: Boolean! + + """Short identifier specified by """ + spdxId: String + + """URL to the license on """ + url: URI +} + +"""Describes a License's conditions, permissions, and limitations""" +type LicenseRule { + """A description of the rule""" + description: String! + + """The machine-readable rule key""" + key: String! + + """The human-readable rule label""" + label: String! +} + +"""Autogenerated input type of LinkRepositoryToProject""" +input LinkRepositoryToProjectInput { + """The ID of the Project to link to a Repository""" + projectId: ID! + + """The ID of the Repository to link to a Project.""" + repositoryId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of LinkRepositoryToProject""" +type LinkRepositoryToProjectPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The linked Project.""" + project: Project + + """The linked Repository.""" + repository: Repository +} + +"""An object that can be locked.""" +interface Lockable { + """Reason that the conversation was locked.""" + activeLockReason: LockReason + + """`true` if the object is locked""" + locked: Boolean! +} + +"""Represents a 'locked' event on a given issue or pull request.""" +type LockedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! + + """Reason that the conversation was locked (optional).""" + lockReason: LockReason + + """Object that was locked.""" + lockable: Lockable! +} + +"""Autogenerated input type of LockLockable""" +input LockLockableInput { + """ID of the issue or pull request to be locked.""" + lockableId: ID! + + """A reason for why the issue or pull request will be locked.""" + lockReason: LockReason + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of LockLockable""" +type LockLockablePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The item that was locked.""" + lockedRecord: Lockable +} + +"""The possible reasons that an issue or pull request was locked.""" +enum LockReason { + """ + The issue or pull request was locked because the conversation was off-topic. + """ + OFF_TOPIC + + """ + The issue or pull request was locked because the conversation was too heated. + """ + TOO_HEATED + + """ + The issue or pull request was locked because the conversation was resolved. + """ + RESOLVED + + """ + The issue or pull request was locked because the conversation was spam. + """ + SPAM +} + +"""A placeholder user for attribution of imported data on GitHub.""" +type Mannequin implements Node & Actor & UniformResourceLocatable { + """A URL pointing to the GitHub App's public avatar.""" + avatarUrl( + """The size of the resulting square image.""" + size: Int + ): URI! + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """Identifies the primary key from the database.""" + databaseId: Int + + """The mannequin's email on the source instance.""" + email: String + id: ID! + + """The username of the actor.""" + login: String! + + """The HTML path to this resource.""" + resourcePath: URI! + + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + + """The URL to this resource.""" + url: URI! +} + +""" +Represents a 'marked_as_duplicate' event on a given issue or pull request. +""" +type MarkedAsDuplicateEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! +} + +"""A public description of a Marketplace category.""" +type MarketplaceCategory implements Node { + """The category's description.""" + description: String + + """ + The technical description of how apps listed in this category work with GitHub. + """ + howItWorks: String + id: ID! + + """The category's name.""" + name: String! + + """How many Marketplace listings have this as their primary category.""" + primaryListingCount: Int! + + """The HTTP path for this Marketplace category.""" + resourcePath: URI! + + """How many Marketplace listings have this as their secondary category.""" + secondaryListingCount: Int! + + """The short name of the category used in its URL.""" + slug: String! + + """The HTTP URL for this Marketplace category.""" + url: URI! +} + +"""A listing in the GitHub integration marketplace.""" +type MarketplaceListing implements Node { + """The GitHub App this listing represents.""" + app: App + + """URL to the listing owner's company site.""" + companyUrl: URI + + """ + The HTTP path for configuring access to the listing's integration or OAuth app + """ + configurationResourcePath: URI! + + """ + The HTTP URL for configuring access to the listing's integration or OAuth app + """ + configurationUrl: URI! + + """URL to the listing's documentation.""" + documentationUrl: URI + + """The listing's detailed description.""" + extendedDescription: String + + """The listing's detailed description rendered to HTML.""" + extendedDescriptionHTML: HTML! + + """The listing's introductory description.""" + fullDescription: String! + + """The listing's introductory description rendered to HTML.""" + fullDescriptionHTML: HTML! + + """Does this listing have any plans with a free trial?""" + hasPublishedFreeTrialPlans: Boolean! + + """Does this listing have a terms of service link?""" + hasTermsOfService: Boolean! + + """A technical description of how this app works with GitHub.""" + howItWorks: String + + """The listing's technical description rendered to HTML.""" + howItWorksHTML: HTML! + id: ID! + + """URL to install the product to the viewer's account or organization.""" + installationUrl: URI + + """Whether this listing's app has been installed for the current viewer""" + installedForViewer: Boolean! + + """Whether this listing has been removed from the Marketplace.""" + isArchived: Boolean! + + """ + Whether this listing is still an editable draft that has not been submitted + for review and is not publicly visible in the Marketplace. + """ + isDraft: Boolean! + + """ + Whether the product this listing represents is available as part of a paid plan. + """ + isPaid: Boolean! + + """Whether this listing has been approved for display in the Marketplace.""" + isPublic: Boolean! + + """ + Whether this listing has been rejected by GitHub for display in the Marketplace. + """ + isRejected: Boolean! + + """ + Whether this listing has been approved for unverified display in the Marketplace. + """ + isUnverified: Boolean! + + """ + Whether this draft listing has been submitted for review for approval to be unverified in the Marketplace. + """ + isUnverifiedPending: Boolean! + + """ + Whether this draft listing has been submitted for review from GitHub for approval to be verified in the Marketplace. + """ + isVerificationPendingFromDraft: Boolean! + + """ + Whether this unverified listing has been submitted for review from GitHub for approval to be verified in the Marketplace. + """ + isVerificationPendingFromUnverified: Boolean! + + """ + Whether this listing has been approved for verified display in the Marketplace. + """ + isVerified: Boolean! + + """The hex color code, without the leading '#', for the logo background.""" + logoBackgroundColor: String! + + """URL for the listing's logo image.""" + logoUrl( + """The size in pixels of the resulting square image.""" + size: Int = 400 + ): URI + + """The listing's full name.""" + name: String! + + """ + The listing's very short description without a trailing period or ampersands. + """ + normalizedShortDescription: String! + + """URL to the listing's detailed pricing.""" + pricingUrl: URI + + """The category that best describes the listing.""" + primaryCategory: MarketplaceCategory! + + """ + URL to the listing's privacy policy, may return an empty string for listings that do not require a privacy policy URL. + """ + privacyPolicyUrl: URI! + + """The HTTP path for the Marketplace listing.""" + resourcePath: URI! + + """The URLs for the listing's screenshots.""" + screenshotUrls: [String]! + + """An alternate category that describes the listing.""" + secondaryCategory: MarketplaceCategory + + """The listing's very short description.""" + shortDescription: String! + + """The short name of the listing used in its URL.""" + slug: String! + + """URL to the listing's status page.""" + statusUrl: URI + + """An email address for support for this listing's app.""" + supportEmail: String + + """ + Either a URL or an email address for support for this listing's app, may + return an empty string for listings that do not require a support URL. + """ + supportUrl: URI! + + """URL to the listing's terms of service.""" + termsOfServiceUrl: URI + + """The HTTP URL for the Marketplace listing.""" + url: URI! + + """Can the current viewer add plans for this Marketplace listing.""" + viewerCanAddPlans: Boolean! + + """Can the current viewer approve this Marketplace listing.""" + viewerCanApprove: Boolean! + + """Can the current viewer delist this Marketplace listing.""" + viewerCanDelist: Boolean! + + """Can the current viewer edit this Marketplace listing.""" + viewerCanEdit: Boolean! + + """ + Can the current viewer edit the primary and secondary category of this + Marketplace listing. + + """ + viewerCanEditCategories: Boolean! + + """Can the current viewer edit the plans for this Marketplace listing.""" + viewerCanEditPlans: Boolean! + + """ + Can the current viewer return this Marketplace listing to draft state + so it becomes editable again. + + """ + viewerCanRedraft: Boolean! + + """ + Can the current viewer reject this Marketplace listing by returning it to + an editable draft state or rejecting it entirely. + + """ + viewerCanReject: Boolean! + + """ + Can the current viewer request this listing be reviewed for display in + the Marketplace as verified. + + """ + viewerCanRequestApproval: Boolean! + + """ + Indicates whether the current user has an active subscription to this Marketplace listing. + + """ + viewerHasPurchased: Boolean! + + """ + Indicates if the current user has purchased a subscription to this Marketplace listing + for all of the organizations the user owns. + + """ + viewerHasPurchasedForAllOrganizations: Boolean! + + """ + Does the current viewer role allow them to administer this Marketplace listing. + + """ + viewerIsListingAdmin: Boolean! +} + +"""Look up Marketplace Listings""" +type MarketplaceListingConnection { + """A list of edges.""" + edges: [MarketplaceListingEdge] + + """A list of nodes.""" + nodes: [MarketplaceListing] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""An edge in a connection.""" +type MarketplaceListingEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: MarketplaceListing +} + +"""Audit log entry for a members_can_delete_repos.clear event.""" +type MembersCanDeleteReposClearAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { + """The action name""" + action: String! + + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! + + """The HTTP path for this enterprise.""" + enterpriseResourcePath: URI + + """The slug of the enterprise.""" + enterpriseSlug: String + + """The HTTP URL for this enterprise.""" + enterpriseUrl: URI + id: ID! + + """The corresponding operation type for the action""" + operationType: OperationType + + """The Organization associated with the Audit Entry.""" + organization: Organization + + """The name of the Organization.""" + organizationName: String + + """The HTTP path for the organization""" + organizationResourcePath: URI + + """The HTTP URL for the organization""" + organizationUrl: URI + + """The user affected by the action""" + user: User + + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String + + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI +} + +"""Audit log entry for a members_can_delete_repos.disable event.""" +type MembersCanDeleteReposDisableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { + """The action name""" + action: String! + + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! + + """The HTTP path for this enterprise.""" + enterpriseResourcePath: URI + + """The slug of the enterprise.""" + enterpriseSlug: String + + """The HTTP URL for this enterprise.""" + enterpriseUrl: URI + id: ID! + + """The corresponding operation type for the action""" + operationType: OperationType + + """The Organization associated with the Audit Entry.""" + organization: Organization + + """The name of the Organization.""" + organizationName: String + + """The HTTP path for the organization""" + organizationResourcePath: URI + + """The HTTP URL for the organization""" + organizationUrl: URI + + """The user affected by the action""" + user: User + + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String + + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI +} + +"""Audit log entry for a members_can_delete_repos.enable event.""" +type MembersCanDeleteReposEnableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { + """The action name""" + action: String! + + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! + + """The HTTP path for this enterprise.""" + enterpriseResourcePath: URI + + """The slug of the enterprise.""" + enterpriseSlug: String + + """The HTTP URL for this enterprise.""" + enterpriseUrl: URI + id: ID! + + """The corresponding operation type for the action""" + operationType: OperationType + + """The Organization associated with the Audit Entry.""" + organization: Organization + + """The name of the Organization.""" + organizationName: String + + """The HTTP path for the organization""" + organizationResourcePath: URI + + """The HTTP URL for the organization""" + organizationUrl: URI + + """The user affected by the action""" + user: User + + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String + + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI +} + +"""Entities that have members who can set status messages.""" +interface MemberStatusable { + """ + Get the status messages members of this entity have set that are either public or visible only to the organization. + """ + memberStatuses( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + + """Ordering options for user statuses returned from the connection.""" + orderBy: UserStatusOrder = {field: UPDATED_AT, direction: DESC} + ): UserStatusConnection! +} + +"""Represents a 'mentioned' event on a given issue or pull request.""" +type MentionedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """Identifies the primary key from the database.""" + databaseId: Int + id: ID! +} + +"""Whether or not a PullRequest can be merged.""" +enum MergeableState { + """The pull request can be merged.""" + MERGEABLE + + """The pull request cannot be merged due to merge conflicts.""" + CONFLICTING + + """The mergeability of the pull request is still being calculated.""" + UNKNOWN +} + +"""Autogenerated input type of MergeBranch""" +input MergeBranchInput { + """ + The Node ID of the Repository containing the base branch that will be modified. + """ + repositoryId: ID! + + """ + The name of the base branch that the provided head will be merged into. + """ + base: String! + + """ + The head to merge into the base branch. This can be a branch name or a commit GitObjectID. + """ + head: String! + + """ + Message to use for the merge commit. If omitted, a default will be used. + """ + commitMessage: String + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of MergeBranch""" +type MergeBranchPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The resulting merge Commit.""" + mergeCommit: Commit +} + +"""Represents a 'merged' event on a given pull request.""" +type MergedEvent implements Node & UniformResourceLocatable { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the commit associated with the `merge` event.""" + commit: Commit + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! + + """Identifies the Ref associated with the `merge` event.""" + mergeRef: Ref + + """Identifies the name of the Ref associated with the `merge` event.""" + mergeRefName: String! + + """PullRequest referenced by event.""" + pullRequest: PullRequest! + + """The HTTP path for this merged event.""" + resourcePath: URI! + + """The HTTP URL for this merged event.""" + url: URI! +} + +"""Autogenerated input type of MergePullRequest""" +input MergePullRequestInput { """ID of the pull request to be merged.""" pullRequestId: ID! @@ -6341,6 +8361,9 @@ input MergePullRequestInput { """ expectedHeadOid: GitObjectID + """The merge method to use. If omitted, defaults to 'MERGE'""" + mergeMethod: PullRequestMergeMethod = MERGE + """A unique identifier for the client performing the mutation.""" clientMutationId: String } @@ -6617,6 +8640,11 @@ type MoveProjectColumnPayload { """The root query for implementing GraphQL mutations.""" type Mutation { + """ + Accepts a pending invitation for a user to become an administrator of an enterprise. + """ + acceptEnterpriseAdministratorInvitation(input: AcceptEnterpriseAdministratorInvitationInput!): AcceptEnterpriseAdministratorInvitationPayload + """Applies a suggested topic to the repository.""" acceptTopicSuggestion(input: AcceptTopicSuggestionInput!): AcceptTopicSuggestionPayload @@ -6649,6 +8677,11 @@ type Mutation { """Adds a star to a Starrable.""" addStar(input: AddStarInput!): AddStarPayload + """ + Cancels a pending invitation for an administrator to join an enterprise. + """ + cancelEnterpriseAdminInvitation(input: CancelEnterpriseAdminInvitationInput!): CancelEnterpriseAdminInvitationPayload + """Update your status on GitHub.""" changeUserStatus(input: ChangeUserStatusInput!): ChangeUserStatusPayload @@ -6685,6 +8718,9 @@ type Mutation { """Create a check suite""" createCheckSuite(input: CreateCheckSuiteInput!): CreateCheckSuitePayload + """Creates an organization as part of an enterprise account.""" + createEnterpriseOrganization(input: CreateEnterpriseOrganizationInput!): CreateEnterpriseOrganizationPayload + """Creates a new issue.""" createIssue(input: CreateIssueInput!): CreateIssuePayload @@ -6700,6 +8736,12 @@ type Mutation { """Create a new repository.""" createRepository(input: CreateRepositoryInput!): CreateRepositoryPayload + """Creates a new team discussion.""" + createTeamDiscussion(input: CreateTeamDiscussionInput!): CreateTeamDiscussionPayload + + """Creates a new team discussion comment.""" + createTeamDiscussionComment(input: CreateTeamDiscussionCommentInput!): CreateTeamDiscussionCommentPayload + """Rejects a suggested topic for the repository.""" declineTopicSuggestion(input: DeclineTopicSuggestionInput!): DeclineTopicSuggestionPayload @@ -6730,9 +8772,21 @@ type Mutation { """Delete a Git Ref.""" deleteRef(input: DeleteRefInput!): DeleteRefPayload + """Deletes a team discussion.""" + deleteTeamDiscussion(input: DeleteTeamDiscussionInput!): DeleteTeamDiscussionPayload + + """Deletes a team discussion comment.""" + deleteTeamDiscussionComment(input: DeleteTeamDiscussionCommentInput!): DeleteTeamDiscussionCommentPayload + """Dismisses an approved or rejected pull request review.""" dismissPullRequestReview(input: DismissPullRequestReviewInput!): DismissPullRequestReviewPayload + """Follow a user.""" + followUser(input: FollowUserInput!): FollowUserPayload + + """Invite someone to become an administrator of the enterprise.""" + inviteEnterpriseAdmin(input: InviteEnterpriseAdminInput!): InviteEnterpriseAdminPayload + """Creates a repository link for a project.""" linkRepositoryToProject(input: LinkRepositoryToProjectInput!): LinkRepositoryToProjectPayload @@ -6751,9 +8805,18 @@ type Mutation { """Moves a project column to another place.""" moveProjectColumn(input: MoveProjectColumnInput!): MoveProjectColumnPayload + """Regenerates the identity provider recovery codes for an enterprise""" + regenerateEnterpriseIdentityProviderRecoveryCodes(input: RegenerateEnterpriseIdentityProviderRecoveryCodesInput!): RegenerateEnterpriseIdentityProviderRecoveryCodesPayload + """Removes assignees from an assignable object.""" removeAssigneesFromAssignable(input: RemoveAssigneesFromAssignableInput!): RemoveAssigneesFromAssignablePayload + """Removes an administrator from the enterprise.""" + removeEnterpriseAdmin(input: RemoveEnterpriseAdminInput!): RemoveEnterpriseAdminPayload + + """Removes an organization from the enterprise""" + removeEnterpriseOrganization(input: RemoveEnterpriseOrganizationInput!): RemoveEnterpriseOrganizationPayload + """Removes labels from a Labelable object.""" removeLabelsFromLabelable(input: RemoveLabelsFromLabelableInput!): RemoveLabelsFromLabelablePayload @@ -6787,6 +8850,9 @@ type Mutation { """Transfer an issue to a different repository""" transferIssue(input: TransferIssueInput!): TransferIssuePayload + """Unfollow a user.""" + unfollowUser(input: UnfollowUserInput!): UnfollowUserPayload + """Deletes a repository link from a project.""" unlinkRepositoryFromProject(input: UnlinkRepositoryFromProjectInput!): UnlinkRepositoryFromProjectPayload @@ -6808,6 +8874,67 @@ type Mutation { """Modifies the settings of an existing check suite""" updateCheckSuitePreferences(input: UpdateCheckSuitePreferencesInput!): UpdateCheckSuitePreferencesPayload + """Sets the action execution capability setting for an enterprise.""" + updateEnterpriseActionExecutionCapabilitySetting(input: UpdateEnterpriseActionExecutionCapabilitySettingInput!): UpdateEnterpriseActionExecutionCapabilitySettingPayload + + """Updates the role of an enterprise administrator.""" + updateEnterpriseAdministratorRole(input: UpdateEnterpriseAdministratorRoleInput!): UpdateEnterpriseAdministratorRolePayload + + """Sets whether private repository forks are enabled for an enterprise.""" + updateEnterpriseAllowPrivateRepositoryForkingSetting(input: UpdateEnterpriseAllowPrivateRepositoryForkingSettingInput!): UpdateEnterpriseAllowPrivateRepositoryForkingSettingPayload + + """ + Sets the default repository permission for organizations in an enterprise. + """ + updateEnterpriseDefaultRepositoryPermissionSetting(input: UpdateEnterpriseDefaultRepositoryPermissionSettingInput!): UpdateEnterpriseDefaultRepositoryPermissionSettingPayload + + """ + Sets whether organization members with admin permissions on a repository can change repository visibility. + """ + updateEnterpriseMembersCanChangeRepositoryVisibilitySetting(input: UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingInput!): UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingPayload + + """Sets the members can create repositories setting for an enterprise.""" + updateEnterpriseMembersCanCreateRepositoriesSetting(input: UpdateEnterpriseMembersCanCreateRepositoriesSettingInput!): UpdateEnterpriseMembersCanCreateRepositoriesSettingPayload + + """Sets the members can delete issues setting for an enterprise.""" + updateEnterpriseMembersCanDeleteIssuesSetting(input: UpdateEnterpriseMembersCanDeleteIssuesSettingInput!): UpdateEnterpriseMembersCanDeleteIssuesSettingPayload + + """Sets the members can delete repositories setting for an enterprise.""" + updateEnterpriseMembersCanDeleteRepositoriesSetting(input: UpdateEnterpriseMembersCanDeleteRepositoriesSettingInput!): UpdateEnterpriseMembersCanDeleteRepositoriesSettingPayload + + """ + Sets whether members can invite collaborators are enabled for an enterprise. + """ + updateEnterpriseMembersCanInviteCollaboratorsSetting(input: UpdateEnterpriseMembersCanInviteCollaboratorsSettingInput!): UpdateEnterpriseMembersCanInviteCollaboratorsSettingPayload + + """Sets whether or not an organization admin can make purchases.""" + updateEnterpriseMembersCanMakePurchasesSetting(input: UpdateEnterpriseMembersCanMakePurchasesSettingInput!): UpdateEnterpriseMembersCanMakePurchasesSettingPayload + + """ + Sets the members can update protected branches setting for an enterprise. + """ + updateEnterpriseMembersCanUpdateProtectedBranchesSetting(input: UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingInput!): UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingPayload + + """Sets the members can view dependency insights for an enterprise.""" + updateEnterpriseMembersCanViewDependencyInsightsSetting(input: UpdateEnterpriseMembersCanViewDependencyInsightsSettingInput!): UpdateEnterpriseMembersCanViewDependencyInsightsSettingPayload + + """Sets whether organization projects are enabled for an enterprise.""" + updateEnterpriseOrganizationProjectsSetting(input: UpdateEnterpriseOrganizationProjectsSettingInput!): UpdateEnterpriseOrganizationProjectsSettingPayload + + """Updates an enterprise's profile.""" + updateEnterpriseProfile(input: UpdateEnterpriseProfileInput!): UpdateEnterpriseProfilePayload + + """Sets whether repository projects are enabled for a enterprise.""" + updateEnterpriseRepositoryProjectsSetting(input: UpdateEnterpriseRepositoryProjectsSettingInput!): UpdateEnterpriseRepositoryProjectsSettingPayload + + """Sets whether team discussions are enabled for an enterprise.""" + updateEnterpriseTeamDiscussionsSetting(input: UpdateEnterpriseTeamDiscussionsSettingInput!): UpdateEnterpriseTeamDiscussionsSettingPayload + + """ + Sets whether two factor authentication is required for all users in an enterprise. + """ + updateEnterpriseTwoFactorAuthenticationRequiredSetting(input: UpdateEnterpriseTwoFactorAuthenticationRequiredSettingInput!): UpdateEnterpriseTwoFactorAuthenticationRequiredSettingPayload + """Updates an Issue.""" updateIssue(input: UpdateIssueInput!): UpdateIssuePayload @@ -6841,6 +8968,12 @@ type Mutation { """Updates the state for subscribable subjects.""" updateSubscription(input: UpdateSubscriptionInput!): UpdateSubscriptionPayload + """Updates a team discussion.""" + updateTeamDiscussion(input: UpdateTeamDiscussionInput!): UpdateTeamDiscussionPayload + + """Updates a discussion comment.""" + updateTeamDiscussionComment(input: UpdateTeamDiscussionCommentInput!): UpdateTeamDiscussionCommentPayload + """Replaces the repository's topics with the given topics.""" updateTopics(input: UpdateTopicsInput!): UpdateTopicsPayload } @@ -6905,6 +9038,9 @@ type OauthApplicationCreateAuditEntry implements Node & AuditEntry & OauthApplic """The HTTP URL for the OAuth Application""" oauthApplicationUrl: URI + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -6966,6 +9102,30 @@ enum OauthApplicationRevokeTokensAuditEntryState { PENDING_DELETION } +"""The corresponding operation type for the action""" +enum OperationType { + """An existing resource was accessed""" + ACCESS + + """A resource performed an authentication event""" + AUTHENTICATION + + """A new resource was created""" + CREATE + + """An existing resource was modified""" + MODIFY + + """An existing resource was removed""" + REMOVE + + """An existing resource was restored""" + RESTORE + + """An existing resource was transferred between multiple resources""" + TRANSFER +} + """ Possible directions in which to order a list of items when provided an `orderBy` argument. """ @@ -7009,6 +9169,9 @@ type OrgAddBillingManagerAuditEntry implements Node & AuditEntry & OrganizationA """ invitationEmail: String + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -7063,6 +9226,9 @@ type OrgAddMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntr createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -7105,7 +9271,7 @@ enum OrgAddMemberAuditEntryPermission { """ An account on GitHub, with one or more owners, that has repositories, members and teams. """ -type Organization implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch & ProjectOwner & RepositoryOwner & UniformResourceLocatable & MemberStatusable & ProfileOwner { +type Organization implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch & ProjectOwner & RepositoryOwner & UniformResourceLocatable & MemberStatusable & ProfileOwner & Sponsorable { """ Determine if this repository owner has any items that can be pinned to their profile. """ @@ -7134,7 +9300,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka query: String """Ordering options for the returned audit log entries.""" - orderBy: AuditLogOrder + orderBy: AuditLogOrder = {field: CREATED_AT, direction: DESC} ): OrganizationAuditEntryConnection! """A URL pointing to the organization's public avatar.""" @@ -7143,12 +9309,18 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka size: Int ): URI! + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + """Identifies the primary key from the database.""" databaseId: Int """The organization's public profile description.""" description: String + """The organization's public profile description rendered to HTML.""" + descriptionHTML: String + """The organization's public email.""" email: String id: ID! @@ -7187,7 +9359,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka last: Int """Ordering options for user statuses returned from the connection.""" - orderBy: UserStatusOrder + orderBy: UserStatusOrder = {field: UPDATED_AT, direction: DESC} ): UserStatusConnection! """A list of users who are members of this organization.""" @@ -7434,17 +9606,66 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka name: String! ): Repository - """ - When true the organization requires all members, billing managers, and outside - collaborators to enable two-factor authentication. - """ - requiresTwoFactorAuthentication: Boolean + """ + When true the organization requires all members, billing managers, and outside + collaborators to enable two-factor authentication. + """ + requiresTwoFactorAuthentication: Boolean + + """The HTTP path for this organization.""" + resourcePath: URI! + + """The Organization's SAML identity providers""" + samlIdentityProvider: OrganizationIdentityProvider + + """This object's sponsorships as the maintainer.""" + sponsorshipsAsMaintainer( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + + """Whether or not to include private sponsorships in the result set""" + includePrivate: Boolean = false + + """ + Ordering options for sponsorships returned from this connection. If left + blank, the sponsorships will be ordered based on relevancy to the viewer. + """ + orderBy: SponsorshipOrder + ): SponsorshipConnection! + + """This object's sponsorships as the sponsor.""" + sponsorshipsAsSponsor( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int - """The HTTP path for this organization.""" - resourcePath: URI! + """Returns the last _n_ elements from the list.""" + last: Int - """The Organization's SAML identity providers""" - samlIdentityProvider: OrganizationIdentityProvider + """ + Ordering options for sponsorships returned from this connection. If left + blank, the sponsorships will be ordered based on relevancy to the viewer. + """ + orderBy: SponsorshipOrder + ): SponsorshipConnection! """Find an organization's team by its slug.""" team( @@ -7500,6 +9721,9 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka """The HTTP URL listing organization's teams""" teamsUrl: URI! + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + """The HTTP URL for this organization.""" url: URI! @@ -7526,7 +9750,7 @@ type Organization implements Node & Actor & RegistryPackageOwner & RegistryPacka } """An audit entry in an organization audit log.""" -union OrganizationAuditEntry = MembersCanDeleteReposClearAuditEntry | MembersCanDeleteReposDisableAuditEntry | MembersCanDeleteReposEnableAuditEntry | OauthApplicationCreateAuditEntry | OrgAddBillingManagerAuditEntry | OrgAddMemberAuditEntry | OrgBlockUserAuditEntry | OrgConfigDisableCollaboratorsOnlyAuditEntry | OrgConfigEnableCollaboratorsOnlyAuditEntry | OrgDisableOauthAppRestrictionsAuditEntry | OrgDisableSamlAuditEntry | OrgDisableTwoFactorRequirementAuditEntry | OrgEnableOauthAppRestrictionsAuditEntry | OrgEnableSamlAuditEntry | OrgEnableTwoFactorRequirementAuditEntry | OrgInviteMemberAuditEntry | OrgInviteToBusinessAuditEntry | OrgOauthAppAccessApprovedAuditEntry | OrgOauthAppAccessDeniedAuditEntry | OrgOauthAppAccessRequestedAuditEntry | OrgRemoveBillingManagerAuditEntry | OrgRemoveMemberAuditEntry | OrgRemoveOutsideCollaboratorAuditEntry | OrgRestoreMemberAuditEntry | OrgUnblockUserAuditEntry | OrgUpdateDefaultRepositoryPermissionAuditEntry | OrgUpdateMemberAuditEntry | OrgUpdateMemberRepositoryCreationPermissionAuditEntry | OrgUpdateMemberRepositoryInvitationPermissionAuditEntry | PrivateRepositoryForkingDisableAuditEntry | PrivateRepositoryForkingEnableAuditEntry | RepoAccessAuditEntry | RepoAddMemberAuditEntry | RepoAddTopicAuditEntry | RepoArchivedAuditEntry | RepoChangeMergeSettingAuditEntry | RepoConfigDisableAnonymousGitAccessAuditEntry | RepoConfigDisableCollaboratorsOnlyAuditEntry | RepoConfigDisableContributorsOnlyAuditEntry | RepoConfigDisableSockpuppetDisallowedAuditEntry | RepoConfigEnableAnonymousGitAccessAuditEntry | RepoConfigEnableCollaboratorsOnlyAuditEntry | RepoConfigEnableContributorsOnlyAuditEntry | RepoConfigEnableSockpuppetDisallowedAuditEntry | RepoConfigLockAnonymousGitAccessAuditEntry | RepoConfigUnlockAnonymousGitAccessAuditEntry | RepoCreateAuditEntry | RepoDestroyAuditEntry | RepoRemoveMemberAuditEntry | RepoRemoveTopicAuditEntry | RepositoryVisibilityChangeDisableAuditEntry | RepositoryVisibilityChangeEnableAuditEntry | TeamAddMemberAuditEntry | TeamAddRepositoryAuditEntry | TeamChangeParentTeamAuditEntry | TeamRemoveMemberAuditEntry | TeamRemoveRepositoryAuditEntry +union OrganizationAuditEntry = MembersCanDeleteReposClearAuditEntry | MembersCanDeleteReposDisableAuditEntry | MembersCanDeleteReposEnableAuditEntry | OauthApplicationCreateAuditEntry | OrgAddBillingManagerAuditEntry | OrgAddMemberAuditEntry | OrgBlockUserAuditEntry | OrgConfigDisableCollaboratorsOnlyAuditEntry | OrgConfigEnableCollaboratorsOnlyAuditEntry | OrgCreateAuditEntry | OrgDisableOauthAppRestrictionsAuditEntry | OrgDisableSamlAuditEntry | OrgDisableTwoFactorRequirementAuditEntry | OrgEnableOauthAppRestrictionsAuditEntry | OrgEnableSamlAuditEntry | OrgEnableTwoFactorRequirementAuditEntry | OrgInviteMemberAuditEntry | OrgInviteToBusinessAuditEntry | OrgOauthAppAccessApprovedAuditEntry | OrgOauthAppAccessDeniedAuditEntry | OrgOauthAppAccessRequestedAuditEntry | OrgRemoveBillingManagerAuditEntry | OrgRemoveMemberAuditEntry | OrgRemoveOutsideCollaboratorAuditEntry | OrgRestoreMemberAuditEntry | OrgUnblockUserAuditEntry | OrgUpdateDefaultRepositoryPermissionAuditEntry | OrgUpdateMemberAuditEntry | OrgUpdateMemberRepositoryCreationPermissionAuditEntry | OrgUpdateMemberRepositoryInvitationPermissionAuditEntry | PrivateRepositoryForkingDisableAuditEntry | PrivateRepositoryForkingEnableAuditEntry | RepoAccessAuditEntry | RepoAddMemberAuditEntry | RepoAddTopicAuditEntry | RepoArchivedAuditEntry | RepoChangeMergeSettingAuditEntry | RepoConfigDisableAnonymousGitAccessAuditEntry | RepoConfigDisableCollaboratorsOnlyAuditEntry | RepoConfigDisableContributorsOnlyAuditEntry | RepoConfigDisableSockpuppetDisallowedAuditEntry | RepoConfigEnableAnonymousGitAccessAuditEntry | RepoConfigEnableCollaboratorsOnlyAuditEntry | RepoConfigEnableContributorsOnlyAuditEntry | RepoConfigEnableSockpuppetDisallowedAuditEntry | RepoConfigLockAnonymousGitAccessAuditEntry | RepoConfigUnlockAnonymousGitAccessAuditEntry | RepoCreateAuditEntry | RepoDestroyAuditEntry | RepoRemoveMemberAuditEntry | RepoRemoveTopicAuditEntry | RepositoryVisibilityChangeDisableAuditEntry | RepositoryVisibilityChangeEnableAuditEntry | TeamAddMemberAuditEntry | TeamAddRepositoryAuditEntry | TeamChangeParentTeamAuditEntry | TeamRemoveMemberAuditEntry | TeamRemoveRepositoryAuditEntry """The connection type for OrganizationAuditEntry.""" type OrganizationAuditEntryConnection { @@ -7752,6 +9976,102 @@ enum OrganizationMemberRole { ADMIN } +""" +The possible values for the members can create repositories setting on an organization. +""" +enum OrganizationMembersCanCreateRepositoriesSettingValue { + """Members will be able to create public and private repositories.""" + ALL + + """Members will be able to create only private repositories.""" + PRIVATE + + """Members will not be able to create public or private repositories.""" + DISABLED +} + +"""Ordering options for organization connections.""" +input OrganizationOrder { + """The field to order organizations by.""" + field: OrganizationOrderField! + + """The ordering direction.""" + direction: OrderDirection! +} + +"""Properties by which organization connections can be ordered.""" +enum OrganizationOrderField { + """Order organizations by creation time""" + CREATED_AT + + """Order organizations by login""" + LOGIN +} + +"""An organization list hovercard context""" +type OrganizationsHovercardContext implements HovercardContext { + """A string describing this context""" + message: String! + + """An octicon to accompany this context""" + octicon: String! + + """Organizations this user is a member of that are relevant""" + relevantOrganizations( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): OrganizationConnection! + + """The total number of organizations this user is in""" + totalOrganizationCount: Int! +} + +"""An organization teams hovercard context""" +type OrganizationTeamsHovercardContext implements HovercardContext { + """A string describing this context""" + message: String! + + """An octicon to accompany this context""" + octicon: String! + + """Teams in this organization the user is a member of that are relevant""" + relevantTeams( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): TeamConnection! + + """The path for the full team list for this user""" + teamsResourcePath: URI! + + """The URL for the full team list for this user""" + teamsUrl: URI! + + """The total number of teams the user is on in the organization""" + totalTeamCount: Int! +} + """Audit log entry for a org.block_user""" type OrgBlockUserAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData { """The action name""" @@ -7791,6 +10111,9 @@ type OrgBlockUserAuditEntry implements Node & AuditEntry & OrganizationAuditEntr createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -7845,6 +10168,9 @@ type OrgConfigDisableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -7899,6 +10225,69 @@ type OrgConfigEnableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & O createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + + """The Organization associated with the Audit Entry.""" + organization: Organization + + """The name of the Organization.""" + organizationName: String + + """The HTTP path for the organization""" + organizationResourcePath: URI + + """The HTTP URL for the organization""" + organizationUrl: URI + + """The user affected by the action""" + user: User + + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String + + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI +} + +"""Audit log entry for a org.create event.""" +type OrgCreateAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData { + """The action name""" + action: String! + + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The billing plan for the Organization.""" + billingPlan: OrgCreateAuditEntryBillingPlan + + """The time the action was initiated""" + createdAt: PreciseDateTime! + id: ID! + + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -7926,6 +10315,24 @@ type OrgConfigEnableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & O userUrl: URI } +"""The billing plans available for organizations.""" +enum OrgCreateAuditEntryBillingPlan { + """Free Plan""" + FREE + + """Team Plan""" + BUSINESS + + """Enterprise Cloud Plan""" + BUSINESS_PLUS + + """Legacy Unlimited Plan""" + UNLIMITED + + """Tiered Per Seat Plan""" + TIERED_PER_SEAT +} + """Audit log entry for a org.disable_oauth_app_restrictions event.""" type OrgDisableOauthAppRestrictionsAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData { """The action name""" @@ -7953,6 +10360,9 @@ type OrgDisableOauthAppRestrictionsAuditEntry implements Node & AuditEntry & Org createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8013,6 +10423,9 @@ type OrgDisableSamlAuditEntry implements Node & AuditEntry & OrganizationAuditEn """The SAML provider's issuer URL.""" issuerUrl: URI + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8073,6 +10486,9 @@ type OrgDisableTwoFactorRequirementAuditEntry implements Node & AuditEntry & Org createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8127,6 +10543,9 @@ type OrgEnableOauthAppRestrictionsAuditEntry implements Node & AuditEntry & Orga createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8187,6 +10606,9 @@ type OrgEnableSamlAuditEntry implements Node & AuditEntry & OrganizationAuditEnt """The SAML provider's issuer URL.""" issuerUrl: URI + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8247,6 +10669,9 @@ type OrgEnableTwoFactorRequirementAuditEntry implements Node & AuditEntry & Orga createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8304,6 +10729,9 @@ type OrgInviteMemberAuditEntry implements Node & AuditEntry & OrganizationAuditE email: String id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8370,6 +10798,9 @@ type OrgInviteToBusinessAuditEntry implements Node & AuditEntry & EnterpriseAudi enterpriseUrl: URI id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8433,6 +10864,9 @@ type OrgOauthAppAccessApprovedAuditEntry implements Node & AuditEntry & OauthApp """The HTTP URL for the OAuth Application""" oauthApplicationUrl: URI + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8496,6 +10930,9 @@ type OrgOauthAppAccessDeniedAuditEntry implements Node & AuditEntry & OauthAppli """The HTTP URL for the OAuth Application""" oauthApplicationUrl: URI + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8559,6 +10996,9 @@ type OrgOauthAppAccessRequestedAuditEntry implements Node & AuditEntry & OauthAp """The HTTP URL for the OAuth Application""" oauthApplicationUrl: URI + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8613,6 +11053,9 @@ type OrgRemoveBillingManagerAuditEntry implements Node & AuditEntry & Organizati createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8687,6 +11130,9 @@ type OrgRemoveMemberAuditEntry implements Node & AuditEntry & OrganizationAuditE """The types of membership the member has with the organization.""" membershipTypes: [OrgRemoveMemberAuditEntryMembershipType!] + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8795,6 +11241,9 @@ type OrgRemoveOutsideCollaboratorAuditEntry implements Node & AuditEntry & Organ """ membershipTypes: [OrgRemoveOutsideCollaboratorAuditEntryMembershipType!] + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -8886,6 +11335,9 @@ type OrgRestoreMemberAuditEntry implements Node & AuditEntry & OrganizationAudit createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -9021,6 +11473,9 @@ type OrgUnblockUserAuditEntry implements Node & AuditEntry & OrganizationAuditEn createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -9075,6 +11530,9 @@ type OrgUpdateDefaultRepositoryPermissionAuditEntry implements Node & AuditEntry createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -9150,6 +11608,9 @@ type OrgUpdateMemberAuditEntry implements Node & AuditEntry & OrganizationAuditE createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -9224,6 +11685,9 @@ type OrgUpdateMemberRepositoryCreationPermissionAuditEntry implements Node & Aud createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -9303,6 +11767,9 @@ type OrgUpdateMemberRepositoryInvitationPermissionAuditEntry implements Node & A createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -9345,15 +11812,6 @@ type PageInfo { startCursor: String } -"""Represents a pending collaborator on a repository.""" -type PendingCollaboratorEdge { - """A cursor for use in pagination.""" - cursor: String! - - """The item at the end of the edge.""" - node: User -} - """Types that can grant permissions on a repository to a user""" union PermissionGranter = Organization | Repository | Team @@ -9484,6 +11942,9 @@ type PrivateRepositoryForkingDisableAuditEntry implements Node & AuditEntry & En enterpriseUrl: URI id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -9559,6 +12020,9 @@ type PrivateRepositoryForkingEnableAuditEntry implements Node & AuditEntry & Ent enterpriseUrl: URI id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -10104,21 +12568,6 @@ enum ProjectState { CLOSED } -"""Represents a connection between a project (parent) and a team (child).""" -type ProjectTeamEdge { - """A cursor for use in pagination.""" - cursor: String! - - """The item at the end of the edge.""" - node: Team - - """The HTTP path for this project's team""" - projectTeamResourcePath: URI! - - """The HTTP URL for this project's team""" - projectTeamUrl: URI! -} - """GitHub-provided templates for Projects""" enum ProjectTemplate { """Create a board with columns for To do, In progress and Done.""" @@ -10140,15 +12589,6 @@ enum ProjectTemplate { BUG_TRIAGE } -"""Represents a user project.""" -type ProjectUserEdge { - """A cursor for use in pagination.""" - cursor: String! - - """The item at the end of the edge.""" - node: User -} - """A user's public key.""" type PublicKey implements Node { """ @@ -10359,6 +12799,12 @@ type PullRequest implements Node & Assignable & Closable & Comment & Updatable & The owner of the repository associated with this pull request's head Ref. """ headRepositoryOwner: RepositoryOwner + + """The hovercard information for this issue""" + hovercard( + """Whether or not to include notification contexts""" + includeNotificationContexts: Boolean = true + ): Hovercard! id: ID! """ @@ -10800,7 +13246,7 @@ type PullRequestContributionsByRepository { last: Int """Ordering options for contributions returned from the connection.""" - orderBy: ContributionOrder + orderBy: ContributionOrder = {field: OCCURRED_AT, direction: DESC} ): CreatedPullRequestContributionConnection! """The repository in which the pull requests were opened.""" @@ -10816,6 +13262,26 @@ type PullRequestEdge { node: PullRequest } +""" +Represents available types of methods to use when merging a pull request. +""" +enum PullRequestMergeMethod { + """ + Add all commits from the head branch to the base branch with a merge commit. + """ + MERGE + + """ + Combine all commits from the head branch into a single commit in the base branch. + """ + SQUASH + + """ + Add all commits from the head branch onto the base branch individually. + """ + REBASE +} + """Ways in which lists of issues can be ordered upon return.""" input PullRequestOrder { """The field in which to order pull requests by.""" @@ -10863,7 +13329,7 @@ type PullRequestReview implements Node & Comment & Deletable & Updatable & Updat """Identifies the pull request review body.""" body: String! - """The body of this review rendered to HTML.""" + """The body rendered to HTML.""" bodyHTML: HTML! """The body of this review rendered as plain text.""" @@ -11021,14 +13487,14 @@ type PullRequestReviewComment implements Node & Comment & Deletable & Updatable """The comment body of this review comment.""" body: String! - """The comment body of this review comment rendered to HTML.""" + """The body rendered to HTML.""" bodyHTML: HTML! """The comment body of this review comment rendered as plain text.""" bodyText: String! """Identifies the commit associated with the comment.""" - commit: Commit! + commit: Commit """Identifies when the comment was created.""" createdAt: DateTime! @@ -11236,7 +13702,7 @@ type PullRequestReviewContributionsByRepository { last: Int """Ordering options for contributions returned from the connection.""" - orderBy: ContributionOrder + orderBy: ContributionOrder = {field: OCCURRED_AT, direction: DESC} ): CreatedPullRequestReviewContributionConnection! """The repository in which the pull request reviews were made.""" @@ -11302,6 +13768,9 @@ type PullRequestReviewThread implements Node { """Returns the last _n_ elements from the list.""" last: Int + + """Skips the first _n_ elements in the list.""" + skip: Int ): PullRequestReviewCommentConnection! id: ID! @@ -11594,6 +14063,15 @@ enum PullRequestTimelineItemsItemType { UNSUBSCRIBED_EVENT } +"""The possible target states when updating a pull request.""" +enum PullRequestUpdateState { + """A pull request that is still open.""" + OPEN + + """A pull request that has been closed without being merged.""" + CLOSED +} + """A Git push.""" type Push implements Node { id: ID! @@ -11614,7 +14092,7 @@ type Push implements Node { repository: Repository! } -"""A team or user who has the ability to push to a protected branch.""" +"""A team, user or app who has the ability to push to a protected branch.""" type PushAllowance implements Node { """The actor that can push.""" actor: PushAllowanceActor @@ -11627,7 +14105,7 @@ type PushAllowance implements Node { } """Types that can be an actor.""" -union PushAllowanceActor = User | Team +union PushAllowanceActor = User | Team | App """The connection type for PushAllowance.""" type PushAllowanceConnection { @@ -11664,6 +14142,37 @@ type Query { """Look up a code of conduct by its key""" codesOfConduct: [CodeOfConduct] + """Look up an enterprise by URL slug.""" + enterprise( + """The enterprise URL slug.""" + slug: String! + + """The enterprise invitation token.""" + invitationToken: String + ): Enterprise + + """ + Look up a pending enterprise administrator invitation by invitee, enterprise and role. + """ + enterpriseAdministratorInvitation( + """The login of the user invited to join the business.""" + userLogin: String! + + """The slug of the enterprise the user was invited to join.""" + enterpriseSlug: String! + + """The role for the business member invitation.""" + role: EnterpriseAdministratorRole! + ): EnterpriseAdministratorInvitation + + """ + Look up a pending enterprise administrator invitation by invitation token. + """ + enterpriseAdministratorInvitationByToken( + """The invitation token sent with the invitation email.""" + invitationToken: String! + ): EnterpriseAdministratorInvitation + """Look up an open source license by its key""" license( """The license's downcased SPDX ID""" @@ -11839,7 +14348,7 @@ type Query { """GitHub Security Advisories""" securityAdvisories( """Ordering options for the returned topics.""" - orderBy: SecurityAdvisoryOrder + orderBy: SecurityAdvisoryOrder = {field: UPDATED_AT, direction: DESC} """Filter advisories by identifier, e.g. GHSA or CVE.""" identifier: SecurityAdvisoryIdentifierFilter @@ -11874,7 +14383,7 @@ type Query { """Software Vulnerabilities documented by GitHub Security Advisories""" securityVulnerabilities( """Ordering options for the returned topics.""" - orderBy: SecurityVulnerabilityOrder + orderBy: SecurityVulnerabilityOrder = {field: UPDATED_AT, direction: DESC} """An ecosystem to filter vulnerabilities by.""" ecosystem: SecurityAdvisoryEcosystem @@ -12046,28 +14555,28 @@ type ReactionConnection { """Emojis that can be attached to Issues, Pull Requests and Comments.""" enum ReactionContent { - """Represents the 👍 emoji.""" + """Represents the `:+1:` emoji.""" THUMBS_UP - """Represents the 👎 emoji.""" + """Represents the `:-1:` emoji.""" THUMBS_DOWN - """Represents the 😄 emoji.""" + """Represents the `:laugh:` emoji.""" LAUGH - """Represents the 🎉 emoji.""" + """Represents the `:hooray:` emoji.""" HOORAY - """Represents the 😕 emoji.""" + """Represents the `:confused:` emoji.""" CONFUSED - """Represents the ❤️ emoji.""" + """Represents the `:heart:` emoji.""" HEART - """Represents the 🚀 emoji.""" + """Represents the `:rocket:` emoji.""" ROCKET - """Represents the 👀 emoji.""" + """Represents the `:eyes:` emoji.""" EYES } @@ -12281,6 +14790,17 @@ input RegenerateEnterpriseIdentityProviderRecoveryCodesInput { clientMutationId: String } +""" +Autogenerated return type of RegenerateEnterpriseIdentityProviderRecoveryCodes +""" +type RegenerateEnterpriseIdentityProviderRecoveryCodesPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The identity provider for the enterprise.""" + identityProvider: EnterpriseIdentityProvider +} + """A registry package contains the content for an uploaded package.""" type RegistryPackage implements Node { """The package type color""" @@ -12797,6 +15317,9 @@ type RegistryPackageVersion implements Node { """Identifies the platform this version was built for.""" platform: String + """Indicates whether this version is a pre-release.""" + preRelease: Boolean! + """The README of this package version""" readme: String @@ -12885,8 +15408,11 @@ type Release implements Node & UniformResourceLocatable { """Identifies the date and time when the object was created.""" createdAt: DateTime! - """Identifies the description of the release.""" + """The description of the release.""" description: String + + """The description of this release rendered to HTML.""" + descriptionHTML: HTML id: ID! """Whether or not the release is a draft""" @@ -12895,7 +15421,7 @@ type Release implements Node & UniformResourceLocatable { """Whether or not the release is a prerelease""" isPrerelease: Boolean! - """Identifies the title of the release.""" + """The title of the release.""" name: String """Identifies the date and time when the release was created.""" @@ -12924,6 +15450,14 @@ type Release implements Node & UniformResourceLocatable { """The HTTP path for this issue""" resourcePath: URI! + """ + A description of the release, rendered to HTML without any links in it. + """ + shortDescriptionHTML( + """How many characters to return.""" + limit: Int = 200 + ): HTML + """The Git tag the release points to""" tag: Ref @@ -13087,13 +15621,22 @@ input RemoveEnterpriseAdminInput { clientMutationId: String } -"""Autogenerated input type of RemoveEnterpriseIdentityProvider""" -input RemoveEnterpriseIdentityProviderInput { - """The ID of the enterprise from which to remove the identity provider.""" - enterpriseId: ID! +"""Autogenerated return type of RemoveEnterpriseAdmin""" +type RemoveEnterpriseAdminPayload { + """The user who was removed as an administrator.""" + admin: User """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The updated enterprise.""" + enterprise: Enterprise + + """A message confirming the result of removing an administrator.""" + message: String + + """The viewer performing the mutation.""" + viewer: User } """Autogenerated input type of RemoveEnterpriseOrganization""" @@ -13110,6 +15653,21 @@ input RemoveEnterpriseOrganizationInput { clientMutationId: String } +"""Autogenerated return type of RemoveEnterpriseOrganization""" +type RemoveEnterpriseOrganizationPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The updated enterprise.""" + enterprise: Enterprise + + """The organization that was removed from the enterprise.""" + organization: Organization + + """The viewer performing the mutation.""" + viewer: User +} + """Autogenerated input type of RemoveLabelsFromLabelable""" input RemoveLabelsFromLabelableInput { """The id of the Labelable to remove labels from.""" @@ -13202,71 +15760,314 @@ type RenamedTitleEvent implements Node { """Identifies the date and time when the object was created.""" createdAt: DateTime! - """Identifies the current title of the issue or pull request.""" - currentTitle: String! + """Identifies the current title of the issue or pull request.""" + currentTitle: String! + id: ID! + + """Identifies the previous title of the issue or pull request.""" + previousTitle: String! + + """Subject that was renamed.""" + subject: RenamedTitleSubject! +} + +"""An object which has a renamable title""" +union RenamedTitleSubject = Issue | PullRequest + +"""Represents a 'reopened' event on any `Closable`.""" +type ReopenedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Object that was reopened.""" + closable: Closable! + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! +} + +"""Autogenerated input type of ReopenIssue""" +input ReopenIssueInput { + """ID of the issue to be opened.""" + issueId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of ReopenIssue""" +type ReopenIssuePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The issue that was opened.""" + issue: Issue +} + +"""Autogenerated input type of ReopenPullRequest""" +input ReopenPullRequestInput { + """ID of the pull request to be reopened.""" + pullRequestId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of ReopenPullRequest""" +type ReopenPullRequestPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The pull request that was reopened.""" + pullRequest: PullRequest +} + +"""Audit log entry for a repo.access event.""" +type RepoAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { + """The action name""" + action: String! + + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! + id: ID! + + """The corresponding operation type for the action""" + operationType: OperationType + + """The Organization associated with the Audit Entry.""" + organization: Organization + + """The name of the Organization.""" + organizationName: String + + """The HTTP path for the organization""" + organizationResourcePath: URI + + """The HTTP URL for the organization""" + organizationUrl: URI + + """The repository associated with the action""" + repository: Repository + + """The name of the repository""" + repositoryName: String + + """The HTTP path for the repository""" + repositoryResourcePath: URI + + """The HTTP URL for the repository""" + repositoryUrl: URI + + """The user affected by the action""" + user: User + + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String + + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI + + """The visibility of the repository""" + visibility: RepoAccessAuditEntryVisibility +} + +"""The privacy of a repository""" +enum RepoAccessAuditEntryVisibility { + """The repository is visible only to users in the same business.""" + INTERNAL + + """The repository is visible only to those with explicit access.""" + PRIVATE + + """The repository is visible to everyone.""" + PUBLIC +} + +"""Audit log entry for a repo.add_member event.""" +type RepoAddMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { + """The action name""" + action: String! + + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! + id: ID! + + """The corresponding operation type for the action""" + operationType: OperationType + + """The Organization associated with the Audit Entry.""" + organization: Organization + + """The name of the Organization.""" + organizationName: String + + """The HTTP path for the organization""" + organizationResourcePath: URI + + """The HTTP URL for the organization""" + organizationUrl: URI + + """The repository associated with the action""" + repository: Repository + + """The name of the repository""" + repositoryName: String + + """The HTTP path for the repository""" + repositoryResourcePath: URI + + """The HTTP URL for the repository""" + repositoryUrl: URI + + """The user affected by the action""" + user: User + + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String + + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI + + """The visibility of the repository""" + visibility: RepoAddMemberAuditEntryVisibility +} + +"""The privacy of a repository""" +enum RepoAddMemberAuditEntryVisibility { + """The repository is visible only to users in the same business.""" + INTERNAL + + """The repository is visible only to those with explicit access.""" + PRIVATE + + """The repository is visible to everyone.""" + PUBLIC +} + +"""Audit log entry for a repo.add_topic event.""" +type RepoAddTopicAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData & TopicAuditEntryData { + """The action name""" + action: String! + + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! id: ID! - """Identifies the previous title of the issue or pull request.""" - previousTitle: String! + """The corresponding operation type for the action""" + operationType: OperationType - """Subject that was renamed.""" - subject: RenamedTitleSubject! -} + """The Organization associated with the Audit Entry.""" + organization: Organization -"""An object which has a renamable title""" -union RenamedTitleSubject = Issue | PullRequest + """The name of the Organization.""" + organizationName: String -"""Represents a 'reopened' event on any `Closable`.""" -type ReopenedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + """The HTTP path for the organization""" + organizationResourcePath: URI - """Object that was reopened.""" - closable: Closable! + """The HTTP URL for the organization""" + organizationUrl: URI - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! -} + """The repository associated with the action""" + repository: Repository -"""Autogenerated input type of ReopenIssue""" -input ReopenIssueInput { - """ID of the issue to be opened.""" - issueId: ID! + """The name of the repository""" + repositoryName: String - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """The HTTP path for the repository""" + repositoryResourcePath: URI -"""Autogenerated return type of ReopenIssue""" -type ReopenIssuePayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """The HTTP URL for the repository""" + repositoryUrl: URI - """The issue that was opened.""" - issue: Issue -} + """The name of the topic added to the repository""" + topic: Topic -"""Autogenerated input type of ReopenPullRequest""" -input ReopenPullRequestInput { - """ID of the pull request to be reopened.""" - pullRequestId: ID! + """The name of the topic added to the repository""" + topicName: String - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """The user affected by the action""" + user: User -"""Autogenerated return type of ReopenPullRequest""" -type ReopenPullRequestPayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String - """The pull request that was reopened.""" - pullRequest: PullRequest + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI } -"""Audit log entry for a repo.access event.""" -type RepoAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.archived event.""" +type RepoArchivedAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { """The action name""" action: String! @@ -13292,6 +16093,9 @@ type RepoAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryD createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13331,11 +16135,11 @@ type RepoAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryD userUrl: URI """The visibility of the repository""" - visibility: RepoAccessAuditEntryVisibility + visibility: RepoArchivedAuditEntryVisibility } """The privacy of a repository""" -enum RepoAccessAuditEntryVisibility { +enum RepoArchivedAuditEntryVisibility { """The repository is visible only to users in the same business.""" INTERNAL @@ -13346,8 +16150,8 @@ enum RepoAccessAuditEntryVisibility { PUBLIC } -"""Audit log entry for a repo.add_member event.""" -type RepoAddMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.change_merge_setting event.""" +type RepoChangeMergeSettingAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { """The action name""" action: String! @@ -13373,6 +16177,17 @@ type RepoAddMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEnt createdAt: PreciseDateTime! id: ID! + """ + Whether the change was to enable (true) or disable (false) the merge type + """ + isEnabled: Boolean + + """The merge method affected by the change""" + mergeType: RepoChangeMergeSettingAuditEntryMergeType + + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13410,25 +16225,26 @@ type RepoAddMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEnt """The HTTP URL for the user.""" userUrl: URI - - """The visibility of the repository""" - visibility: RepoAddMemberAuditEntryVisibility } -"""The privacy of a repository""" -enum RepoAddMemberAuditEntryVisibility { - """The repository is visible only to users in the same business.""" - INTERNAL +"""The merge options available for pull requests to this repository.""" +enum RepoChangeMergeSettingAuditEntryMergeType { + """The pull request is added to the base branch in a merge commit.""" + MERGE - """The repository is visible only to those with explicit access.""" - PRIVATE + """ + Commits from the pull request are added onto the base branch individually without a merge commit. + """ + REBASE - """The repository is visible to everyone.""" - PUBLIC + """ + The pull request's commits are squashed into a single commit before they are merged to the base branch. + """ + SQUASH } -"""Audit log entry for a repo.add_topic event.""" -type RepoAddTopicAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData & TopicAuditEntryData { +"""Audit log entry for a repo.config.disable_anonymous_git_access event.""" +type RepoConfigDisableAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13454,6 +16270,9 @@ type RepoAddTopicAuditEntry implements Node & AuditEntry & RepositoryAuditEntryD createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13478,12 +16297,6 @@ type RepoAddTopicAuditEntry implements Node & AuditEntry & RepositoryAuditEntryD """The HTTP URL for the repository""" repositoryUrl: URI - """The name of the topic added to the repository""" - topic: Topic - - """The name of the topic added to the repository""" - topicName: String - """The user affected by the action""" user: User @@ -13499,8 +16312,8 @@ type RepoAddTopicAuditEntry implements Node & AuditEntry & RepositoryAuditEntryD userUrl: URI } -"""Audit log entry for a repo.archived event.""" -type RepoArchivedAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { +"""Audit log entry for a repo.config.disable_collaborators_only event.""" +type RepoConfigDisableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13526,6 +16339,9 @@ type RepoArchivedAuditEntry implements Node & AuditEntry & RepositoryAuditEntryD createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13563,25 +16379,10 @@ type RepoArchivedAuditEntry implements Node & AuditEntry & RepositoryAuditEntryD """The HTTP URL for the user.""" userUrl: URI - - """The visibility of the repository""" - visibility: RepoArchivedAuditEntryVisibility } -"""The privacy of a repository""" -enum RepoArchivedAuditEntryVisibility { - """The repository is visible only to users in the same business.""" - INTERNAL - - """The repository is visible only to those with explicit access.""" - PRIVATE - - """The repository is visible to everyone.""" - PUBLIC -} - -"""Audit log entry for a repo.change_merge_setting event.""" -type RepoChangeMergeSettingAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { +"""Audit log entry for a repo.config.disable_contributors_only event.""" +type RepoConfigDisableContributorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13607,13 +16408,8 @@ type RepoChangeMergeSettingAuditEntry implements Node & AuditEntry & RepositoryA createdAt: PreciseDateTime! id: ID! - """ - Whether the change was to enable (true) or disable (false) the merge type - """ - isEnabled: Boolean - - """The merge method affected by the change""" - mergeType: RepoChangeMergeSettingAuditEntryMergeType + """The corresponding operation type for the action""" + operationType: OperationType """The Organization associated with the Audit Entry.""" organization: Organization @@ -13654,24 +16450,77 @@ type RepoChangeMergeSettingAuditEntry implements Node & AuditEntry & RepositoryA userUrl: URI } -"""The merge options available for pull requests to this repository.""" -enum RepoChangeMergeSettingAuditEntryMergeType { - """The pull request is added to the base branch in a merge commit.""" - MERGE +"""Audit log entry for a repo.config.disable_sockpuppet_disallowed event.""" +type RepoConfigDisableSockpuppetDisallowedAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { + """The action name""" + action: String! - """ - Commits from the pull request are added onto the base branch individually without a merge commit. - """ - REBASE + """The user who initiated the action""" + actor: AuditEntryActor + + """The IP address of the actor""" + actorIp: String + + """A readable representation of the actor's location""" + actorLocation: ActorLocation + + """The username of the user who initiated the action""" + actorLogin: String + + """The HTTP path for the actor.""" + actorResourcePath: URI + + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! + id: ID! + + """The corresponding operation type for the action""" + operationType: OperationType + + """The Organization associated with the Audit Entry.""" + organization: Organization + + """The name of the Organization.""" + organizationName: String + + """The HTTP path for the organization""" + organizationResourcePath: URI + + """The HTTP URL for the organization""" + organizationUrl: URI + + """The repository associated with the action""" + repository: Repository + + """The name of the repository""" + repositoryName: String + + """The HTTP path for the repository""" + repositoryResourcePath: URI + + """The HTTP URL for the repository""" + repositoryUrl: URI + + """The user affected by the action""" + user: User """ - The pull request's commits are squashed into a single commit before they are merged to the base branch. + For actions involving two users, the actor is the initiator and the user is the affected user. """ - SQUASH + userLogin: String + + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI } -"""Audit log entry for a repo.config.disable_anonymous_git_access event.""" -type RepoConfigDisableAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.config.enable_anonymous_git_access event.""" +type RepoConfigEnableAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13697,6 +16546,9 @@ type RepoConfigDisableAnonymousGitAccessAuditEntry implements Node & AuditEntry createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13736,8 +16588,8 @@ type RepoConfigDisableAnonymousGitAccessAuditEntry implements Node & AuditEntry userUrl: URI } -"""Audit log entry for a repo.config.disable_collaborators_only event.""" -type RepoConfigDisableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.config.enable_collaborators_only event.""" +type RepoConfigEnableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13763,6 +16615,9 @@ type RepoConfigDisableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13802,8 +16657,8 @@ type RepoConfigDisableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & userUrl: URI } -"""Audit log entry for a repo.config.disable_contributors_only event.""" -type RepoConfigDisableContributorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.config.enable_contributors_only event.""" +type RepoConfigEnableContributorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13829,6 +16684,9 @@ type RepoConfigDisableContributorsOnlyAuditEntry implements Node & AuditEntry & createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13867,9 +16725,9 @@ type RepoConfigDisableContributorsOnlyAuditEntry implements Node & AuditEntry & """The HTTP URL for the user.""" userUrl: URI } - -"""Audit log entry for a repo.config.disable_sockpuppet_disallowed event.""" -type RepoConfigDisableSockpuppetDisallowedAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { + +"""Audit log entry for a repo.config.enable_sockpuppet_disallowed event.""" +type RepoConfigEnableSockpuppetDisallowedAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13895,6 +16753,9 @@ type RepoConfigDisableSockpuppetDisallowedAuditEntry implements Node & AuditEntr createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -13934,8 +16795,8 @@ type RepoConfigDisableSockpuppetDisallowedAuditEntry implements Node & AuditEntr userUrl: URI } -"""Audit log entry for a repo.config.enable_anonymous_git_access event.""" -type RepoConfigEnableAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.config.lock_anonymous_git_access event.""" +type RepoConfigLockAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -13961,6 +16822,9 @@ type RepoConfigEnableAnonymousGitAccessAuditEntry implements Node & AuditEntry & createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -14000,8 +16864,8 @@ type RepoConfigEnableAnonymousGitAccessAuditEntry implements Node & AuditEntry & userUrl: URI } -"""Audit log entry for a repo.config.enable_collaborators_only event.""" -type RepoConfigEnableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.config.unlock_anonymous_git_access event.""" +type RepoConfigUnlockAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -14027,6 +16891,9 @@ type RepoConfigEnableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -14066,8 +16933,8 @@ type RepoConfigEnableCollaboratorsOnlyAuditEntry implements Node & AuditEntry & userUrl: URI } -"""Audit log entry for a repo.config.enable_contributors_only event.""" -type RepoConfigEnableContributorsOnlyAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""Audit log entry for a repo.create event.""" +type RepoCreateAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { """The action name""" action: String! @@ -14091,8 +16958,17 @@ type RepoConfigEnableContributorsOnlyAuditEntry implements Node & AuditEntry & O """The time the action was initiated""" createdAt: PreciseDateTime! + + """The name of the parent repository for this forked repository.""" + forkParentName: String + + """The name of the root repository for this netork.""" + forkSourceName: String id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -14130,10 +17006,25 @@ type RepoConfigEnableContributorsOnlyAuditEntry implements Node & AuditEntry & O """The HTTP URL for the user.""" userUrl: URI + + """The visibility of the repository""" + visibility: RepoCreateAuditEntryVisibility } -"""Audit log entry for a repo.config.enable_sockpuppet_disallowed event.""" -type RepoConfigEnableSockpuppetDisallowedAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""The privacy of a repository""" +enum RepoCreateAuditEntryVisibility { + """The repository is visible only to users in the same business.""" + INTERNAL + + """The repository is visible only to those with explicit access.""" + PRIVATE + + """The repository is visible to everyone.""" + PUBLIC +} + +"""Audit log entry for a repo.destroy event.""" +type RepoDestroyAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { """The action name""" action: String! @@ -14159,6 +17050,9 @@ type RepoConfigEnableSockpuppetDisallowedAuditEntry implements Node & AuditEntry createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -14196,10 +17090,25 @@ type RepoConfigEnableSockpuppetDisallowedAuditEntry implements Node & AuditEntry """The HTTP URL for the user.""" userUrl: URI + + """The visibility of the repository""" + visibility: RepoDestroyAuditEntryVisibility } -"""Audit log entry for a repo.config.lock_anonymous_git_access event.""" -type RepoConfigLockAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""The privacy of a repository""" +enum RepoDestroyAuditEntryVisibility { + """The repository is visible only to users in the same business.""" + INTERNAL + + """The repository is visible only to those with explicit access.""" + PRIVATE + + """The repository is visible to everyone.""" + PUBLIC +} + +"""Audit log entry for a repo.remove_member event.""" +type RepoRemoveMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { """The action name""" action: String! @@ -14225,6 +17134,9 @@ type RepoConfigLockAnonymousGitAccessAuditEntry implements Node & AuditEntry & O createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -14262,10 +17174,25 @@ type RepoConfigLockAnonymousGitAccessAuditEntry implements Node & AuditEntry & O """The HTTP URL for the user.""" userUrl: URI + + """The visibility of the repository""" + visibility: RepoRemoveMemberAuditEntryVisibility } -"""Audit log entry for a repo.config.unlock_anonymous_git_access event.""" -type RepoConfigUnlockAnonymousGitAccessAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { +"""The privacy of a repository""" +enum RepoRemoveMemberAuditEntryVisibility { + """The repository is visible only to users in the same business.""" + INTERNAL + + """The repository is visible only to those with explicit access.""" + PRIVATE + + """The repository is visible to everyone.""" + PUBLIC +} + +"""Audit log entry for a repo.remove_topic event.""" +type RepoRemoveTopicAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData & TopicAuditEntryData { """The action name""" action: String! @@ -14291,6 +17218,9 @@ type RepoConfigUnlockAnonymousGitAccessAuditEntry implements Node & AuditEntry & createdAt: PreciseDateTime! id: ID! + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -14315,6 +17245,12 @@ type RepoConfigUnlockAnonymousGitAccessAuditEntry implements Node & AuditEntry & """The HTTP URL for the repository""" repositoryUrl: URI + """The name of the topic added to the repository""" + topic: Topic + + """The name of the topic added to the repository""" + topicName: String + """The user affected by the action""" user: User @@ -14330,349 +17266,579 @@ type RepoConfigUnlockAnonymousGitAccessAuditEntry implements Node & AuditEntry & userUrl: URI } -"""Audit log entry for a repo.create event.""" -type RepoCreateAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { - """The action name""" - action: String! +"""The reasons a piece of content can be reported or minimized.""" +enum ReportedContentClassifiers { + """A spammy piece of content""" + SPAM - """The user who initiated the action""" - actor: AuditEntryActor + """An abusive or harassing piece of content""" + ABUSE + + """An irrelevant piece of content""" + OFF_TOPIC + + """An outdated piece of content""" + OUTDATED + + """The content has been resolved""" + RESOLVED +} + +"""A repository contains the content for a project.""" +type Repository implements Node & ProjectOwner & RegistryPackageOwner & RegistryPackageSearch & Subscribable & Starrable & UniformResourceLocatable & RepositoryInfo { + """A list of users that can be assigned to issues in this repository.""" + assignableUsers( + """Filters users with query on user name and login""" + query: String + + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): UserConnection! + + """A list of branch protection rules for this repository.""" + branchProtectionRules( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): BranchProtectionRuleConnection! + + """Returns the code of conduct for this repository""" + codeOfConduct: CodeOfConduct + + """A list of collaborators associated with the repository.""" + collaborators( + """Collaborators affiliation level with a repository.""" + affiliation: CollaboratorAffiliation + + """Filters users with query on user name and login""" + query: String + + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): RepositoryCollaboratorConnection + + """A list of commit comments associated with the repository.""" + commitComments( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): CommitCommentConnection! + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + + """Identifies the primary key from the database.""" + databaseId: Int + + """The Ref associated with the repository's default branch.""" + defaultBranchRef: Ref + + """A list of deploy keys that are on this repository.""" + deployKeys( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): DeployKeyConnection! + + """Deployments associated with the repository""" + deployments( + """Environments to list deployments for""" + environments: [String!] + + """Ordering options for deployments returned from the connection.""" + orderBy: DeploymentOrder = {field: CREATED_AT, direction: ASC} + + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + ): DeploymentConnection! + + """The description of the repository.""" + description: String + + """The description of the repository rendered to HTML.""" + descriptionHTML: HTML! + + """The number of kilobytes this repository occupies on disk.""" + diskUsage: Int + + """ + Returns how many forks there are of this repository in the whole network. + """ + forkCount: Int! + + """A list of direct forked repositories.""" + forks( + """If non-null, filters repositories according to privacy""" + privacy: RepositoryPrivacy - """The IP address of the actor""" - actorIp: String + """Ordering options for repositories returned from the connection""" + orderBy: RepositoryOrder - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """ + Array of viewer's affiliation options for repositories returned from the + connection. For example, OWNER will include only repositories that the + current viewer owns. + """ + affiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] - """The username of the user who initiated the action""" - actorLogin: String + """ + Array of owner's affiliation options for repositories returned from the + connection. For example, OWNER will include only repositories that the + organization or user being viewed owns. + """ + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] - """The HTTP path for the actor.""" - actorResourcePath: URI + """ + If non-null, filters repositories according to whether they have been locked + """ + isLocked: Boolean - """The HTTP URL for the actor.""" - actorUrl: URI + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The time the action was initiated""" - createdAt: PreciseDateTime! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The name of the parent repository for this forked repository.""" - forkParentName: String + """Returns the first _n_ elements from the list.""" + first: Int - """The name of the root repository for this netork.""" - forkSourceName: String - id: ID! + """Returns the last _n_ elements from the list.""" + last: Int + ): RepositoryConnection! - """The Organization associated with the Audit Entry.""" - organization: Organization + """Indicates if the repository has issues feature enabled.""" + hasIssuesEnabled: Boolean! - """The name of the Organization.""" - organizationName: String + """Indicates if the repository has wiki feature enabled.""" + hasWikiEnabled: Boolean! - """The HTTP path for the organization""" - organizationResourcePath: URI + """The repository's URL.""" + homepageUrl: URI + id: ID! - """The HTTP URL for the organization""" - organizationUrl: URI + """Indicates if the repository is unmaintained.""" + isArchived: Boolean! - """The repository associated with the action""" - repository: Repository + """Returns whether or not this repository disabled.""" + isDisabled: Boolean! - """The name of the repository""" - repositoryName: String + """Identifies if the repository is a fork.""" + isFork: Boolean! - """The HTTP path for the repository""" - repositoryResourcePath: URI + """Indicates if the repository has been locked or not.""" + isLocked: Boolean! - """The HTTP URL for the repository""" - repositoryUrl: URI + """Identifies if the repository is a mirror.""" + isMirror: Boolean! - """The user affected by the action""" - user: User + """Identifies if the repository is private.""" + isPrivate: Boolean! """ - For actions involving two users, the actor is the initiator and the user is the affected user. + Identifies if the repository is a template that can be used to generate new repositories. """ - userLogin: String + isTemplate: Boolean! - """The HTTP path for the user.""" - userResourcePath: URI + """Returns a single issue from the current repository by number.""" + issue( + """The number for the issue to be returned.""" + number: Int! + ): Issue - """The HTTP URL for the user.""" - userUrl: URI + """ + Returns a single issue-like object from the current repository by number. + """ + issueOrPullRequest( + """The number for the issue to be returned.""" + number: Int! + ): IssueOrPullRequest - """The visibility of the repository""" - visibility: RepoCreateAuditEntryVisibility -} + """A list of issues that have been opened in the repository.""" + issues( + """Ordering options for issues returned from the connection.""" + orderBy: IssueOrder -"""The privacy of a repository""" -enum RepoCreateAuditEntryVisibility { - """The repository is visible only to users in the same business.""" - INTERNAL + """A list of label names to filter the pull requests by.""" + labels: [String!] - """The repository is visible only to those with explicit access.""" - PRIVATE + """A list of states to filter the issues by.""" + states: [IssueState!] - """The repository is visible to everyone.""" - PUBLIC -} + """Filtering options for issues returned from the connection.""" + filterBy: IssueFilters -"""Audit log entry for a repo.destroy event.""" -type RepoDestroyAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData { - """The action name""" - action: String! + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The user who initiated the action""" - actor: AuditEntryActor + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The IP address of the actor""" - actorIp: String + """Returns the first _n_ elements from the list.""" + first: Int - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """Returns the last _n_ elements from the list.""" + last: Int + ): IssueConnection! - """The username of the user who initiated the action""" - actorLogin: String + """Returns a single label by name""" + label( + """Label name""" + name: String! + ): Label - """The HTTP path for the actor.""" - actorResourcePath: URI + """A list of labels associated with the repository.""" + labels( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The HTTP URL for the actor.""" - actorUrl: URI + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The time the action was initiated""" - createdAt: PreciseDateTime! - id: ID! + """Returns the first _n_ elements from the list.""" + first: Int - """The Organization associated with the Audit Entry.""" - organization: Organization + """Returns the last _n_ elements from the list.""" + last: Int - """The name of the Organization.""" - organizationName: String + """If provided, searches labels by name and description.""" + query: String + ): LabelConnection - """The HTTP path for the organization""" - organizationResourcePath: URI + """ + A list containing a breakdown of the language composition of the repository. + """ + languages( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The HTTP URL for the organization""" - organizationUrl: URI + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The repository associated with the action""" - repository: Repository + """Returns the first _n_ elements from the list.""" + first: Int - """The name of the repository""" - repositoryName: String + """Returns the last _n_ elements from the list.""" + last: Int - """The HTTP path for the repository""" - repositoryResourcePath: URI + """Order for connection""" + orderBy: LanguageOrder + ): LanguageConnection - """The HTTP URL for the repository""" - repositoryUrl: URI + """The license associated with the repository""" + licenseInfo: License - """The user affected by the action""" - user: User + """The reason the repository has been locked.""" + lockReason: RepositoryLockReason """ - For actions involving two users, the actor is the initiator and the user is the affected user. + A list of Users that can be mentioned in the context of the repository. """ - userLogin: String + mentionableUsers( + """Filters users with query on user name and login""" + query: String - """The HTTP path for the user.""" - userResourcePath: URI + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The HTTP URL for the user.""" - userUrl: URI + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The visibility of the repository""" - visibility: RepoDestroyAuditEntryVisibility -} + """Returns the first _n_ elements from the list.""" + first: Int -"""The privacy of a repository""" -enum RepoDestroyAuditEntryVisibility { - """The repository is visible only to users in the same business.""" - INTERNAL + """Returns the last _n_ elements from the list.""" + last: Int + ): UserConnection! + + """Whether or not PRs are merged with a merge commit on this repository.""" + mergeCommitAllowed: Boolean! + + """Returns a single milestone from the current repository by number.""" + milestone( + """The number for the milestone to be returned.""" + number: Int! + ): Milestone + + """A list of milestones associated with the repository.""" + milestones( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The repository is visible only to those with explicit access.""" - PRIVATE + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The repository is visible to everyone.""" - PUBLIC -} + """Returns the first _n_ elements from the list.""" + first: Int -"""Audit log entry for a repo.remove_member event.""" -type RepoRemoveMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData { - """The action name""" - action: String! + """Returns the last _n_ elements from the list.""" + last: Int - """The user who initiated the action""" - actor: AuditEntryActor + """Filter by the state of the milestones.""" + states: [MilestoneState!] - """The IP address of the actor""" - actorIp: String + """Ordering options for milestones.""" + orderBy: MilestoneOrder + ): MilestoneConnection - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """The repository's original mirror URL.""" + mirrorUrl: URI - """The username of the user who initiated the action""" - actorLogin: String + """The name of the repository.""" + name: String! - """The HTTP path for the actor.""" - actorResourcePath: URI + """The repository's name with owner.""" + nameWithOwner: String! - """The HTTP URL for the actor.""" - actorUrl: URI + """A Git object in the repository""" + object( + """The Git object ID""" + oid: GitObjectID - """The time the action was initiated""" - createdAt: PreciseDateTime! - id: ID! + """A Git revision expression suitable for rev-parse""" + expression: String + ): GitObject - """The Organization associated with the Audit Entry.""" - organization: Organization + """The image used to represent this repository in Open Graph data.""" + openGraphImageUrl: URI! - """The name of the Organization.""" - organizationName: String + """The User owner of the repository.""" + owner: RepositoryOwner! - """The HTTP path for the organization""" - organizationResourcePath: URI + """The repository parent, if this is a fork.""" + parent: Repository - """The HTTP URL for the organization""" - organizationUrl: URI + """The primary language of the repository's code.""" + primaryLanguage: Language - """The repository associated with the action""" - repository: Repository + """Find project by number.""" + project( + """The project number to find.""" + number: Int! + ): Project - """The name of the repository""" - repositoryName: String + """A list of projects under the owner.""" + projects( + """Ordering options for projects returned from the connection""" + orderBy: ProjectOrder - """The HTTP path for the repository""" - repositoryResourcePath: URI + """Query to search projects by, currently only searching by name.""" + search: String - """The HTTP URL for the repository""" - repositoryUrl: URI + """A list of states to filter the projects by.""" + states: [ProjectState!] - """The user affected by the action""" - user: User + """Returns the elements in the list that come after the specified cursor.""" + after: String - """ - For actions involving two users, the actor is the initiator and the user is the affected user. - """ - userLogin: String + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The HTTP path for the user.""" - userResourcePath: URI + """Returns the first _n_ elements from the list.""" + first: Int - """The HTTP URL for the user.""" - userUrl: URI + """Returns the last _n_ elements from the list.""" + last: Int + ): ProjectConnection! - """The visibility of the repository""" - visibility: RepoRemoveMemberAuditEntryVisibility -} + """The HTTP path listing the repository's projects""" + projectsResourcePath: URI! -"""The privacy of a repository""" -enum RepoRemoveMemberAuditEntryVisibility { - """The repository is visible only to users in the same business.""" - INTERNAL + """The HTTP URL listing the repository's projects""" + projectsUrl: URI! - """The repository is visible only to those with explicit access.""" - PRIVATE + """Returns a single pull request from the current repository by number.""" + pullRequest( + """The number for the pull request to be returned.""" + number: Int! + ): PullRequest - """The repository is visible to everyone.""" - PUBLIC -} + """A list of pull requests that have been opened in the repository.""" + pullRequests( + """A list of states to filter the pull requests by.""" + states: [PullRequestState!] -"""Audit log entry for a repo.remove_topic event.""" -type RepoRemoveTopicAuditEntry implements Node & AuditEntry & RepositoryAuditEntryData & OrganizationAuditEntryData & TopicAuditEntryData { - """The action name""" - action: String! + """A list of label names to filter the pull requests by.""" + labels: [String!] - """The user who initiated the action""" - actor: AuditEntryActor + """The head ref name to filter the pull requests by.""" + headRefName: String - """The IP address of the actor""" - actorIp: String + """The base ref name to filter the pull requests by.""" + baseRefName: String - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """Ordering options for pull requests returned from the connection.""" + orderBy: IssueOrder - """The username of the user who initiated the action""" - actorLogin: String + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The HTTP path for the actor.""" - actorResourcePath: URI + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The HTTP URL for the actor.""" - actorUrl: URI + """Returns the first _n_ elements from the list.""" + first: Int - """The time the action was initiated""" - createdAt: PreciseDateTime! - id: ID! + """Returns the last _n_ elements from the list.""" + last: Int + ): PullRequestConnection! - """The Organization associated with the Audit Entry.""" - organization: Organization + """Identifies when the repository was last pushed to.""" + pushedAt: DateTime - """The name of the Organization.""" - organizationName: String + """Whether or not rebase-merging is enabled on this repository.""" + rebaseMergeAllowed: Boolean! - """The HTTP path for the organization""" - organizationResourcePath: URI + """Fetch a given ref from the repository""" + ref( + """ + The ref to retrieve. Fully qualified matches are checked in order + (`refs/heads/master`) before falling back onto checks for short name matches (`master`). + """ + qualifiedName: String! + ): Ref - """The HTTP URL for the organization""" - organizationUrl: URI + """Fetch a list of refs from the repository""" + refs( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The repository associated with the action""" - repository: Repository + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The name of the repository""" - repositoryName: String + """Returns the first _n_ elements from the list.""" + first: Int - """The HTTP path for the repository""" - repositoryResourcePath: URI + """Returns the last _n_ elements from the list.""" + last: Int - """The HTTP URL for the repository""" - repositoryUrl: URI + """A ref name prefix like `refs/heads/`, `refs/tags/`, etc.""" + refPrefix: String! - """The name of the topic added to the repository""" - topic: Topic + """DEPRECATED: use orderBy. The ordering direction.""" + direction: OrderDirection - """The name of the topic added to the repository""" - topicName: String + """Ordering options for refs returned from the connection.""" + orderBy: RefOrder + ): RefConnection - """The user affected by the action""" - user: User + """A list of registry packages under the owner.""" + registryPackages( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """ - For actions involving two users, the actor is the initiator and the user is the affected user. - """ - userLogin: String + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The HTTP path for the user.""" - userResourcePath: URI + """Returns the first _n_ elements from the list.""" + first: Int - """The HTTP URL for the user.""" - userUrl: URI -} + """Returns the last _n_ elements from the list.""" + last: Int -"""The reasons a piece of content can be reported or minimized.""" -enum ReportedContentClassifiers { - """A spammy piece of content""" - SPAM + """Find registry package by name.""" + name: String + + """Find registry packages by their names.""" + names: [String] - """An abusive or harassing piece of content""" - ABUSE + """Find registry packages in a repository.""" + repositoryId: ID - """An irrelevant piece of content""" - OFF_TOPIC + """Filter registry package by type.""" + packageType: RegistryPackageType - """An outdated piece of content""" - OUTDATED + """Filter registry package by type (string).""" + registryPackageType: String - """The content has been resolved""" - RESOLVED -} + """Filter registry package by whether it is publicly visible""" + publicOnly: Boolean = false + ): RegistryPackageConnection! -"""A repository contains the content for a project.""" -type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscribable & Starrable & UniformResourceLocatable & RepositoryInfo { - """A list of users that can be assigned to issues in this repository.""" - assignableUsers( + """A list of registry packages for a particular search query.""" + registryPackagesForQuery( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -14686,10 +17852,22 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Returns the last _n_ elements from the list.""" last: Int - ): UserConnection! - """A list of branch protection rules for this repository.""" - branchProtectionRules( + """Find registry package by search query.""" + query: String + + """Filter registry package by type.""" + packageType: RegistryPackageType + ): RegistryPackageConnection! + + """Lookup a single release given various criteria.""" + release( + """The name of the Tag the Release was created from""" + tagName: String! + ): Release + + """List of releases which are dependent on this repository.""" + releases( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -14703,16 +17881,13 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Returns the last _n_ elements from the list.""" last: Int - ): BranchProtectionRuleConnection! - - """Returns the code of conduct for this repository""" - codeOfConduct: CodeOfConduct - """A list of collaborators associated with the repository.""" - collaborators( - """Collaborators affiliation level with a repository.""" - affiliation: CollaboratorAffiliation + """Order for connection""" + orderBy: ReleaseOrder + ): ReleaseConnection! + """A list of applied repository-topic associations for this repository.""" + repositoryTopics( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -14726,10 +17901,27 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Returns the last _n_ elements from the list.""" last: Int - ): RepositoryCollaboratorConnection + ): RepositoryTopicConnection! - """A list of commit comments associated with the repository.""" - commitComments( + """The HTTP path for this repository""" + resourcePath: URI! + + """ + A description of the repository, rendered to HTML without any links in it. + """ + shortDescriptionHTML( + """How many characters to return.""" + limit: Int = 200 + ): HTML! + + """Whether or not squash-merging is enabled on this repository.""" + squashMergeAllowed: Boolean! + + """The SSH URL to clone this repository""" + sshUrl: GitSSHRemote! + + """A list of users who have starred this starrable.""" + stargazers( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -14743,19 +17935,56 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Returns the last _n_ elements from the list.""" last: Int - ): CommitCommentConnection! - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """Order for connection""" + orderBy: StarOrder + ): StargazerConnection! - """Identifies the primary key from the database.""" - databaseId: Int + """The repository from which this repository was generated, if any.""" + templateRepository: Repository - """The Ref associated with the repository's default branch.""" - defaultBranchRef: Ref + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! - """A list of deploy keys that are on this repository.""" - deployKeys( + """The HTTP URL for this repository""" + url: URI! + + """ + Whether this repository has a custom image to use with Open Graph as opposed to being represented by the owner's avatar. + """ + usesCustomOpenGraphImage: Boolean! + + """Indicates whether the viewer has admin permissions on this repository.""" + viewerCanAdminister: Boolean! + + """Can the current viewer create new projects on this owner.""" + viewerCanCreateProjects: Boolean! + + """ + Check if the viewer is able to change their subscription status for the repository. + """ + viewerCanSubscribe: Boolean! + + """Indicates whether the viewer can update the topics of this repository.""" + viewerCanUpdateTopics: Boolean! + + """ + Returns a boolean indicating whether the viewing user has starred this starrable. + """ + viewerHasStarred: Boolean! + + """ + The users permission level on the repository. Will return null if authenticated as an GitHub App. + """ + viewerPermission: RepositoryPermission + + """ + Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. + """ + viewerSubscription: SubscriptionState + + """A list of vulnerability alerts that are on this repository.""" + vulnerabilityAlerts( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -14769,16 +17998,10 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Returns the last _n_ elements from the list.""" last: Int - ): DeployKeyConnection! - - """Deployments associated with the repository""" - deployments( - """Environments to list deployments for""" - environments: [String!] - - """Ordering options for deployments returned from the connection.""" - orderBy: DeploymentOrder + ): RepositoryVulnerabilityAlertConnection + """A list of users watching the repository.""" + watchers( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -14792,63 +18015,136 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Returns the last _n_ elements from the list.""" last: Int - ): DeploymentConnection! - - """The description of the repository.""" - description: String + ): UserConnection! +} - """The description of the repository rendered to HTML.""" - descriptionHTML: HTML! +"""The affiliation of a user to a repository""" +enum RepositoryAffiliation { + """Repositories that are owned by the authenticated user.""" + OWNER - """The number of kilobytes this repository occupies on disk.""" - diskUsage: Int + """Repositories that the user has been added to as a collaborator.""" + COLLABORATOR """ - Returns how many forks there are of this repository in the whole network. + Repositories that the user has access to through being a member of an + organization. This includes every repository on every team that the user is on. """ - forkCount: Int! + ORGANIZATION_MEMBER +} - """A list of direct forked repositories.""" - forks( - """If non-null, filters repositories according to privacy""" - privacy: RepositoryPrivacy +"""Metadata for an audit entry with action repo.*""" +interface RepositoryAuditEntryData { + """The repository associated with the action""" + repository: Repository - """Ordering options for repositories returned from the connection""" - orderBy: RepositoryOrder + """The name of the repository""" + repositoryName: String - """ - Array of viewer's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - current viewer owns. - """ - affiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] + """The HTTP path for the repository""" + repositoryResourcePath: URI + + """The HTTP URL for the repository""" + repositoryUrl: URI +} + +"""The affiliation type between collaborator and repository.""" +enum RepositoryCollaboratorAffiliation { + """All collaborators of the repository.""" + ALL + + """All outside collaborators of an organization-owned repository.""" + OUTSIDE +} + +"""The connection type for User.""" +type RepositoryCollaboratorConnection { + """A list of edges.""" + edges: [RepositoryCollaboratorEdge] + + """A list of nodes.""" + nodes: [User] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! +} + +"""Represents a user who is a collaborator of a repository.""" +type RepositoryCollaboratorEdge { + """A cursor for use in pagination.""" + cursor: String! + node: User! + + """The permission the user has on the repository.""" + permission: RepositoryPermission! + + """A list of sources for the user's access to the repository.""" + permissionSources: [PermissionSource!] +} + +"""A list of repositories owned by the subject.""" +type RepositoryConnection { + """A list of edges.""" + edges: [RepositoryEdge] + + """A list of nodes.""" + nodes: [Repository] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! + + """The total size in kilobytes of all repositories in the connection.""" + totalDiskUsage: Int! +} + +"""The reason a repository is listed as 'contributed'.""" +enum RepositoryContributionType { + """Created a commit""" + COMMIT + + """Created an issue""" + ISSUE + + """Created a pull request""" + PULL_REQUEST + + """Created the repository""" + REPOSITORY + + """Reviewed a pull request""" + PULL_REQUEST_REVIEW +} - """ - Array of owner's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - organization or user being viewed owns. - """ - ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] +"""An edge in a connection.""" +type RepositoryEdge { + """A cursor for use in pagination.""" + cursor: String! - """ - If non-null, filters repositories according to whether they have been locked - """ - isLocked: Boolean + """The item at the end of the edge.""" + node: Repository +} - """Returns the elements in the list that come after the specified cursor.""" - after: String +"""A subset of repository info.""" +interface RepositoryInfo { + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The description of the repository.""" + description: String - """Returns the first _n_ elements from the list.""" - first: Int + """The description of the repository rendered to HTML.""" + descriptionHTML: HTML! - """Returns the last _n_ elements from the list.""" - last: Int - ): RepositoryConnection! + """ + Returns how many forks there are of this repository in the whole network. + """ + forkCount: Int! """Indicates if the repository has issues feature enabled.""" hasIssuesEnabled: Boolean! @@ -14858,14 +18154,10 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """The repository's URL.""" homepageUrl: URI - id: ID! """Indicates if the repository is unmaintained.""" isArchived: Boolean! - """Returns whether or not this repository disabled.""" - isDisabled: Boolean! - """Identifies if the repository is a fork.""" isFork: Boolean! @@ -14883,154 +18175,12 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """ isTemplate: Boolean! - """Returns a single issue from the current repository by number.""" - issue( - """The number for the issue to be returned.""" - number: Int! - ): Issue - - """ - Returns a single issue-like object from the current repository by number. - """ - issueOrPullRequest( - """The number for the issue to be returned.""" - number: Int! - ): IssueOrPullRequest - - """A list of issues that have been opened in the repository.""" - issues( - """Ordering options for issues returned from the connection.""" - orderBy: IssueOrder - - """A list of label names to filter the pull requests by.""" - labels: [String!] - - """A list of states to filter the issues by.""" - states: [IssueState!] - - """Filtering options for issues returned from the connection.""" - filterBy: IssueFilters - - """Returns the elements in the list that come after the specified cursor.""" - after: String - - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String - - """Returns the first _n_ elements from the list.""" - first: Int - - """Returns the last _n_ elements from the list.""" - last: Int - ): IssueConnection! - - """Returns a single label by name""" - label( - """Label name""" - name: String! - ): Label - - """A list of labels associated with the repository.""" - labels( - """Returns the elements in the list that come after the specified cursor.""" - after: String - - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String - - """Returns the first _n_ elements from the list.""" - first: Int - - """Returns the last _n_ elements from the list.""" - last: Int - - """If provided, searches labels by name and description.""" - query: String - ): LabelConnection - - """ - A list containing a breakdown of the language composition of the repository. - """ - languages( - """Returns the elements in the list that come after the specified cursor.""" - after: String - - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String - - """Returns the first _n_ elements from the list.""" - first: Int - - """Returns the last _n_ elements from the list.""" - last: Int - - """Order for connection""" - orderBy: LanguageOrder - ): LanguageConnection - """The license associated with the repository""" licenseInfo: License """The reason the repository has been locked.""" lockReason: RepositoryLockReason - """ - A list of Users that can be mentioned in the context of the repository. - """ - mentionableUsers( - """Returns the elements in the list that come after the specified cursor.""" - after: String - - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String - - """Returns the first _n_ elements from the list.""" - first: Int - - """Returns the last _n_ elements from the list.""" - last: Int - ): UserConnection! - - """Whether or not PRs are merged with a merge commit on this repository.""" - mergeCommitAllowed: Boolean! - - """Returns a single milestone from the current repository by number.""" - milestone( - """The number for the milestone to be returned.""" - number: Int! - ): Milestone - - """A list of milestones associated with the repository.""" - milestones( - """Returns the elements in the list that come after the specified cursor.""" - after: String - - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String - - """Returns the first _n_ elements from the list.""" - first: Int - - """Returns the last _n_ elements from the list.""" - last: Int - - """Filter by the state of the milestones.""" - states: [MilestoneState!] - - """Ordering options for milestones.""" - orderBy: MilestoneOrder - ): MilestoneConnection - """The repository's original mirror URL.""" mirrorUrl: URI @@ -15040,120 +18190,169 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """The repository's name with owner.""" nameWithOwner: String! - """A Git object in the repository""" - object( - """The Git object ID""" - oid: GitObjectID - - """A Git revision expression suitable for rev-parse""" - expression: String - ): GitObject - """The image used to represent this repository in Open Graph data.""" openGraphImageUrl: URI! """The User owner of the repository.""" owner: RepositoryOwner! - """The repository parent, if this is a fork.""" - parent: Repository + """Identifies when the repository was last pushed to.""" + pushedAt: DateTime - """The primary language of the repository's code.""" - primaryLanguage: Language + """The HTTP path for this repository""" + resourcePath: URI! - """Find project by number.""" - project( - """The project number to find.""" - number: Int! - ): Project + """ + A description of the repository, rendered to HTML without any links in it. + """ + shortDescriptionHTML( + """How many characters to return.""" + limit: Int = 200 + ): HTML! + + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + + """The HTTP URL for this repository""" + url: URI! + + """ + Whether this repository has a custom image to use with Open Graph as opposed to being represented by the owner's avatar. + """ + usesCustomOpenGraphImage: Boolean! +} + +"""An invitation for a user to be added to a repository.""" +type RepositoryInvitation implements Node { + id: ID! + + """The user who received the invitation.""" + invitee: User! + + """The user who created the invitation.""" + inviter: User! + + """The permission granted on this repository by this invitation.""" + permission: RepositoryPermission! + + """The Repository the user is invited to.""" + repository: RepositoryInfo +} + +"""An edge in a connection.""" +type RepositoryInvitationEdge { + """A cursor for use in pagination.""" + cursor: String! + + """The item at the end of the edge.""" + node: RepositoryInvitation +} - """A list of projects under the owner.""" - projects( - """Ordering options for projects returned from the connection""" - orderBy: ProjectOrder +"""Ordering options for repository invitation connections.""" +input RepositoryInvitationOrder { + """The field to order repository invitations by.""" + field: RepositoryInvitationOrderField! - """Query to search projects by, currently only searching by name.""" - search: String + """The ordering direction.""" + direction: OrderDirection! +} - """A list of states to filter the projects by.""" - states: [ProjectState!] +"""Properties by which repository invitation connections can be ordered.""" +enum RepositoryInvitationOrderField { + """Order repository invitations by creation time""" + CREATED_AT - """Returns the elements in the list that come after the specified cursor.""" - after: String + """Order repository invitations by invitee login""" + INVITEE_LOGIN +} - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String +"""The possible reasons a given repository could be in a locked state.""" +enum RepositoryLockReason { + """The repository is locked due to a move.""" + MOVING - """Returns the first _n_ elements from the list.""" - first: Int + """The repository is locked due to a billing related reason.""" + BILLING - """Returns the last _n_ elements from the list.""" - last: Int - ): ProjectConnection! + """The repository is locked due to a rename.""" + RENAME - """The HTTP path listing the repository's projects""" - projectsResourcePath: URI! + """The repository is locked due to a migration.""" + MIGRATING +} - """The HTTP URL listing the repository's projects""" - projectsUrl: URI! +"""Represents a object that belongs to a repository.""" +interface RepositoryNode { + """The repository associated with this node.""" + repository: Repository! +} - """Returns a single pull request from the current repository by number.""" - pullRequest( - """The number for the pull request to be returned.""" - number: Int! - ): PullRequest +"""Ordering options for repository connections""" +input RepositoryOrder { + """The field to order repositories by.""" + field: RepositoryOrderField! - """A list of pull requests that have been opened in the repository.""" - pullRequests( - """A list of states to filter the pull requests by.""" - states: [PullRequestState!] + """The ordering direction.""" + direction: OrderDirection! +} - """A list of label names to filter the pull requests by.""" - labels: [String!] +"""Properties by which repository connections can be ordered.""" +enum RepositoryOrderField { + """Order repositories by creation time""" + CREATED_AT - """The head ref name to filter the pull requests by.""" - headRefName: String + """Order repositories by update time""" + UPDATED_AT - """The base ref name to filter the pull requests by.""" - baseRefName: String + """Order repositories by push time""" + PUSHED_AT - """Ordering options for pull requests returned from the connection.""" - orderBy: IssueOrder + """Order repositories by name""" + NAME - """Returns the elements in the list that come after the specified cursor.""" - after: String + """Order repositories by number of stargazers""" + STARGAZERS +} - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String +"""Represents an owner of a Repository.""" +interface RepositoryOwner { + """A URL pointing to the owner's public avatar.""" + avatarUrl( + """The size of the resulting square image.""" + size: Int + ): URI! + id: ID! - """Returns the first _n_ elements from the list.""" - first: Int + """The username used to login.""" + login: String! - """Returns the last _n_ elements from the list.""" - last: Int - ): PullRequestConnection! + """A list of repositories that the user owns.""" + repositories( + """If non-null, filters repositories according to privacy""" + privacy: RepositoryPrivacy - """Identifies when the repository was last pushed to.""" - pushedAt: DateTime + """Ordering options for repositories returned from the connection""" + orderBy: RepositoryOrder - """Whether or not rebase-merging is enabled on this repository.""" - rebaseMergeAllowed: Boolean! + """ + Array of viewer's affiliation options for repositories returned from the + connection. For example, OWNER will include only repositories that the + current viewer owns. + """ + affiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] - """Fetch a given ref from the repository""" - ref( """ - The ref to retrieve. Fully qualified matches are checked in order - (`refs/heads/master`) before falling back onto checks for short name matches (`master`). + Array of owner's affiliation options for repositories returned from the + connection. For example, OWNER will include only repositories that the + organization or user being viewed owns. """ - qualifiedName: String! - ): Ref + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] + + """ + If non-null, filters repositories according to whether they have been locked + """ + isLocked: Boolean - """Fetch a list of refs from the repository""" - refs( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -15168,613 +18367,638 @@ type Repository implements Node & ProjectOwner & RegistryPackageOwner & Subscrib """Returns the last _n_ elements from the list.""" last: Int - """A ref name prefix like `refs/heads/`, `refs/tags/`, etc.""" - refPrefix: String! - - """DEPRECATED: use orderBy. The ordering direction.""" - direction: OrderDirection + """ + If non-null, filters repositories according to whether they are forks of another repository + """ + isFork: Boolean + ): RepositoryConnection! - """Ordering options for refs returned from the connection.""" - orderBy: RefOrder - ): RefConnection + """Find Repository.""" + repository( + """Name of Repository to find.""" + name: String! + ): Repository - """A list of registry packages under the owner.""" - registryPackages( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The HTTP URL for the owner.""" + resourcePath: URI! - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The HTTP URL for the owner.""" + url: URI! +} - """Returns the first _n_ elements from the list.""" - first: Int +"""The access level to a repository""" +enum RepositoryPermission { + """ + Can read, clone, and push to this repository. Can also manage issues, pull + requests, and repository settings, including adding collaborators + """ + ADMIN - """Returns the last _n_ elements from the list.""" - last: Int + """ + Can read, clone, and push to this repository. They can also manage issues, pull requests, and some repository settings + """ + MAINTAIN - """Find registry package by name.""" - name: String + """ + Can read, clone, and push to this repository. Can also manage issues and pull requests + """ + WRITE - """Find registry packages by their names.""" - names: [String] + """ + Can read and clone this repository. Can also manage issues and pull requests + """ + TRIAGE - """Find registry packages in a repository.""" - repositoryId: ID + """ + Can read and clone this repository. Can also open and comment on issues and pull requests + """ + READ +} - """Filter registry package by type.""" - packageType: RegistryPackageType +"""The privacy of a repository""" +enum RepositoryPrivacy { + """Public""" + PUBLIC - """Filter registry package by type (string).""" - registryPackageType: String + """Private""" + PRIVATE +} - """Filter registry package by whether it is publicly visible""" - publicOnly: Boolean = false - ): RegistryPackageConnection! +"""A repository-topic connects a repository to a topic.""" +type RepositoryTopic implements Node & UniformResourceLocatable { + id: ID! - """Lookup a single release given various criteria.""" - release( - """The name of the Tag the Release was created from""" - tagName: String! - ): Release + """The HTTP path for this repository-topic.""" + resourcePath: URI! - """List of releases which are dependent on this repository.""" - releases( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The topic.""" + topic: Topic! - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The HTTP URL for this repository-topic.""" + url: URI! +} - """Returns the first _n_ elements from the list.""" - first: Int +"""The connection type for RepositoryTopic.""" +type RepositoryTopicConnection { + """A list of edges.""" + edges: [RepositoryTopicEdge] - """Returns the last _n_ elements from the list.""" - last: Int + """A list of nodes.""" + nodes: [RepositoryTopic] - """Order for connection""" - orderBy: ReleaseOrder - ): ReleaseConnection! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """A list of applied repository-topic associations for this repository.""" - repositoryTopics( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String +"""An edge in a connection.""" +type RepositoryTopicEdge { + """A cursor for use in pagination.""" + cursor: String! - """Returns the first _n_ elements from the list.""" - first: Int + """The item at the end of the edge.""" + node: RepositoryTopic +} - """Returns the last _n_ elements from the list.""" - last: Int - ): RepositoryTopicConnection! +"""The repository's visibility level.""" +enum RepositoryVisibility { + """The repository is visible only to those with explicit access.""" + PRIVATE - """The HTTP path for this repository""" - resourcePath: URI! + """The repository is visible to everyone.""" + PUBLIC - """ - A description of the repository, rendered to HTML without any links in it. - """ - shortDescriptionHTML( - """How many characters to return.""" - limit: Int = 200 - ): HTML! + """The repository is visible only to users in the same business.""" + INTERNAL +} - """Whether or not squash-merging is enabled on this repository.""" - squashMergeAllowed: Boolean! +"""Audit log entry for a repository_visibility_change.disable event.""" +type RepositoryVisibilityChangeDisableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { + """The action name""" + action: String! - """The SSH URL to clone this repository""" - sshUrl: GitSSHRemote! + """The user who initiated the action""" + actor: AuditEntryActor - """A list of users who have starred this starrable.""" - stargazers( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The IP address of the actor""" + actorIp: String - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """A readable representation of the actor's location""" + actorLocation: ActorLocation - """Returns the first _n_ elements from the list.""" - first: Int + """The username of the user who initiated the action""" + actorLogin: String - """Returns the last _n_ elements from the list.""" - last: Int + """The HTTP path for the actor.""" + actorResourcePath: URI - """Order for connection""" - orderBy: StarOrder - ): StargazerConnection! + """The HTTP URL for the actor.""" + actorUrl: URI - """The repository from which this repository was generated, if any.""" - templateRepository: Repository + """The time the action was initiated""" + createdAt: PreciseDateTime! - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! + """The HTTP path for this enterprise.""" + enterpriseResourcePath: URI - """The HTTP URL for this repository""" - url: URI! + """The slug of the enterprise.""" + enterpriseSlug: String - """ - Whether this repository has a custom image to use with Open Graph as opposed to being represented by the owner's avatar. - """ - usesCustomOpenGraphImage: Boolean! + """The HTTP URL for this enterprise.""" + enterpriseUrl: URI + id: ID! - """Indicates whether the viewer has admin permissions on this repository.""" - viewerCanAdminister: Boolean! + """The corresponding operation type for the action""" + operationType: OperationType - """Can the current viewer create new projects on this owner.""" - viewerCanCreateProjects: Boolean! + """The Organization associated with the Audit Entry.""" + organization: Organization - """ - Check if the viewer is able to change their subscription status for the repository. - """ - viewerCanSubscribe: Boolean! + """The name of the Organization.""" + organizationName: String - """Indicates whether the viewer can update the topics of this repository.""" - viewerCanUpdateTopics: Boolean! + """The HTTP path for the organization""" + organizationResourcePath: URI - """ - Returns a boolean indicating whether the viewing user has starred this starrable. - """ - viewerHasStarred: Boolean! + """The HTTP URL for the organization""" + organizationUrl: URI - """ - The users permission level on the repository. Will return null if authenticated as an GitHub App. - """ - viewerPermission: RepositoryPermission + """The user affected by the action""" + user: User """ - Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. + For actions involving two users, the actor is the initiator and the user is the affected user. """ - viewerSubscription: SubscriptionState + userLogin: String - """A list of users watching the repository.""" - watchers( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The HTTP path for the user.""" + userResourcePath: URI - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The HTTP URL for the user.""" + userUrl: URI +} - """Returns the first _n_ elements from the list.""" - first: Int +"""Audit log entry for a repository_visibility_change.enable event.""" +type RepositoryVisibilityChangeEnableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { + """The action name""" + action: String! - """Returns the last _n_ elements from the list.""" - last: Int - ): UserConnection! -} + """The user who initiated the action""" + actor: AuditEntryActor -"""The affiliation of a user to a repository""" -enum RepositoryAffiliation { - """Repositories that are owned by the authenticated user.""" - OWNER + """The IP address of the actor""" + actorIp: String - """Repositories that the user has been added to as a collaborator.""" - COLLABORATOR + """A readable representation of the actor's location""" + actorLocation: ActorLocation - """ - Repositories that the user has access to through being a member of an - organization. This includes every repository on every team that the user is on. - """ - ORGANIZATION_MEMBER -} + """The username of the user who initiated the action""" + actorLogin: String -"""Metadata for an audit entry with action repo.*""" -interface RepositoryAuditEntryData { - """The repository associated with the action""" - repository: Repository + """The HTTP path for the actor.""" + actorResourcePath: URI - """The name of the repository""" - repositoryName: String + """The HTTP URL for the actor.""" + actorUrl: URI - """The HTTP path for the repository""" - repositoryResourcePath: URI + """The time the action was initiated""" + createdAt: PreciseDateTime! - """The HTTP URL for the repository""" - repositoryUrl: URI -} + """The HTTP path for this enterprise.""" + enterpriseResourcePath: URI -"""The affiliation type between collaborator and repository.""" -enum RepositoryCollaboratorAffiliation { - """All collaborators of the repository.""" - ALL + """The slug of the enterprise.""" + enterpriseSlug: String - """All outside collaborators of an organization-owned repository.""" - OUTSIDE -} + """The HTTP URL for this enterprise.""" + enterpriseUrl: URI + id: ID! -"""The connection type for User.""" -type RepositoryCollaboratorConnection { - """A list of edges.""" - edges: [RepositoryCollaboratorEdge] + """The corresponding operation type for the action""" + operationType: OperationType - """A list of nodes.""" - nodes: [User] + """The Organization associated with the Audit Entry.""" + organization: Organization - """Information to aid in pagination.""" - pageInfo: PageInfo! + """The name of the Organization.""" + organizationName: String - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """The HTTP path for the organization""" + organizationResourcePath: URI -"""Represents a user who is a collaborator of a repository.""" -type RepositoryCollaboratorEdge { - """A cursor for use in pagination.""" - cursor: String! - node: User! + """The HTTP URL for the organization""" + organizationUrl: URI - """The permission the user has on the repository.""" - permission: RepositoryPermission! + """The user affected by the action""" + user: User - """A list of sources for the user's access to the repository.""" - permissionSources: [PermissionSource!] -} + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String -"""A list of repositories owned by the subject.""" -type RepositoryConnection { - """A list of edges.""" - edges: [RepositoryEdge] + """The HTTP path for the user.""" + userResourcePath: URI - """A list of nodes.""" - nodes: [Repository] + """The HTTP URL for the user.""" + userUrl: URI +} - """Information to aid in pagination.""" - pageInfo: PageInfo! +"""A alert for a repository with an affected vulnerability.""" +type RepositoryVulnerabilityAlert implements Node & RepositoryNode { + """The reason the alert was dismissed""" + dismissReason: String - """Identifies the total count of items in the connection.""" - totalCount: Int! + """When was the alert dimissed?""" + dismissedAt: DateTime - """The total size in kilobytes of all repositories in the connection.""" - totalDiskUsage: Int! -} + """The user who dismissed the alert""" + dismisser: User + id: ID! -"""The reason a repository is listed as 'contributed'.""" -enum RepositoryContributionType { - """Created a commit""" - COMMIT + """The associated repository""" + repository: Repository! - """Created an issue""" - ISSUE + """The associated security advisory""" + securityAdvisory: SecurityAdvisory - """Created a pull request""" - PULL_REQUEST + """The associated security vulnerablity""" + securityVulnerability: SecurityVulnerability - """Created the repository""" - REPOSITORY + """The vulnerable manifest filename""" + vulnerableManifestFilename: String! - """Reviewed a pull request""" - PULL_REQUEST_REVIEW + """The vulnerable manifest path""" + vulnerableManifestPath: String! + + """The vulnerable requirements""" + vulnerableRequirements: String } -"""A user who has contributed to a repository.""" -type RepositoryContributorEdge { - """The number of contributions the user has made in the repository.""" - contributionsCount: Int! +"""The connection type for RepositoryVulnerabilityAlert.""" +type RepositoryVulnerabilityAlertConnection { + """A list of edges.""" + edges: [RepositoryVulnerabilityAlertEdge] - """A cursor for use in pagination.""" - cursor: String! + """A list of nodes.""" + nodes: [RepositoryVulnerabilityAlert] - """The item at the end of the edge.""" - node: User + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! } """An edge in a connection.""" -type RepositoryEdge { +type RepositoryVulnerabilityAlertEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: Repository + node: RepositoryVulnerabilityAlert } -"""A subset of repository info.""" -interface RepositoryInfo { - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - - """The description of the repository.""" - description: String +"""The possible states that can be requested when creating a check run.""" +enum RequestableCheckStatusState { + """The check suite or run has been queued.""" + QUEUED - """The description of the repository rendered to HTML.""" - descriptionHTML: HTML! + """The check suite or run is in progress.""" + IN_PROGRESS - """ - Returns how many forks there are of this repository in the whole network. - """ - forkCount: Int! + """The check suite or run has been completed.""" + COMPLETED +} - """Indicates if the repository has issues feature enabled.""" - hasIssuesEnabled: Boolean! +"""Types that can be requested reviewers.""" +union RequestedReviewer = User | Team | Mannequin - """Indicates if the repository has wiki feature enabled.""" - hasWikiEnabled: Boolean! +"""Autogenerated input type of RequestReviews""" +input RequestReviewsInput { + """The Node ID of the pull request to modify.""" + pullRequestId: ID! - """The repository's URL.""" - homepageUrl: URI + """The Node IDs of the user to request.""" + userIds: [ID!] - """Indicates if the repository is unmaintained.""" - isArchived: Boolean! + """The Node IDs of the team to request.""" + teamIds: [ID!] - """Identifies if the repository is a fork.""" - isFork: Boolean! + """Add users to the set rather than replace.""" + union: Boolean - """Indicates if the repository has been locked or not.""" - isLocked: Boolean! + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} - """Identifies if the repository is a mirror.""" - isMirror: Boolean! +"""Autogenerated return type of RequestReviews""" +type RequestReviewsPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String - """Identifies if the repository is private.""" - isPrivate: Boolean! + """The pull request that is getting requests.""" + pullRequest: PullRequest - """ - Identifies if the repository is a template that can be used to generate new repositories. - """ - isTemplate: Boolean! + """The edge from the pull request to the requested reviewers.""" + requestedReviewersEdge: UserEdge +} - """The license associated with the repository""" - licenseInfo: License +"""Autogenerated input type of RerequestCheckSuite""" +input RerequestCheckSuiteInput { + """The Node ID of the repository.""" + repositoryId: ID! - """The reason the repository has been locked.""" - lockReason: RepositoryLockReason + """The Node ID of the check suite.""" + checkSuiteId: ID! - """The repository's original mirror URL.""" - mirrorUrl: URI + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} - """The name of the repository.""" - name: String! +"""Autogenerated return type of RerequestCheckSuite""" +type RerequestCheckSuitePayload { + """The requested check suite.""" + checkSuite: CheckSuite - """The repository's name with owner.""" - nameWithOwner: String! + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} - """The image used to represent this repository in Open Graph data.""" - openGraphImageUrl: URI! +"""Autogenerated input type of ResolveReviewThread""" +input ResolveReviewThreadInput { + """The ID of the thread to resolve""" + threadId: ID! - """The User owner of the repository.""" - owner: RepositoryOwner! + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} - """Identifies when the repository was last pushed to.""" - pushedAt: DateTime +"""Autogenerated return type of ResolveReviewThread""" +type ResolveReviewThreadPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String - """The HTTP path for this repository""" - resourcePath: URI! + """The thread to resolve.""" + thread: PullRequestReviewThread +} +"""Represents a private contribution a user made on GitHub.""" +type RestrictedContribution implements Contribution { """ - A description of the repository, rendered to HTML without any links in it. + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ - shortDescriptionHTML( - """How many characters to return.""" - limit: Int = 200 - ): HTML! + isRestricted: Boolean! - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! + """When this contribution was made.""" + occurredAt: DateTime! - """The HTTP URL for this repository""" + """The HTTP path for this contribution.""" + resourcePath: URI! + + """The HTTP URL for this contribution.""" url: URI! """ - Whether this repository has a custom image to use with Open Graph as opposed to being represented by the owner's avatar. + The user who made this contribution. + """ - usesCustomOpenGraphImage: Boolean! + user: User! } -"""An invitation for a user to be added to a repository.""" -type RepositoryInvitation implements Node { +""" +A team or user who has the ability to dismiss a review on a protected branch. +""" +type ReviewDismissalAllowance implements Node { + """The actor that can dismiss.""" + actor: ReviewDismissalAllowanceActor + + """ + Identifies the branch protection rule associated with the allowed user or team. + """ + branchProtectionRule: BranchProtectionRule id: ID! +} - """The user who received the invitation.""" - invitee: User! +"""Types that can be an actor.""" +union ReviewDismissalAllowanceActor = User | Team - """The user who created the invitation.""" - inviter: User! +"""The connection type for ReviewDismissalAllowance.""" +type ReviewDismissalAllowanceConnection { + """A list of edges.""" + edges: [ReviewDismissalAllowanceEdge] - """The permission granted on this repository by this invitation.""" - permission: RepositoryPermission! + """A list of nodes.""" + nodes: [ReviewDismissalAllowance] - """The Repository the user is invited to.""" - repository: RepositoryInfo + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! } """An edge in a connection.""" -type RepositoryInvitationEdge { +type ReviewDismissalAllowanceEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: RepositoryInvitation + node: ReviewDismissalAllowance } -"""The possible reasons a given repository could be in a locked state.""" -enum RepositoryLockReason { - """The repository is locked due to a move.""" - MOVING +""" +Represents a 'review_dismissed' event on a given issue or pull request. +""" +type ReviewDismissedEvent implements Node & UniformResourceLocatable { + """Identifies the actor who performed the event.""" + actor: Actor - """The repository is locked due to a billing related reason.""" - BILLING + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """The repository is locked due to a rename.""" - RENAME + """Identifies the primary key from the database.""" + databaseId: Int - """The repository is locked due to a migration.""" - MIGRATING -} + """ + Identifies the optional message associated with the 'review_dismissed' event. + """ + dismissalMessage: String -"""Represents a object that belongs to a repository.""" -interface RepositoryNode { - """The repository associated with this node.""" - repository: Repository! -} + """ + Identifies the optional message associated with the event, rendered to HTML. + """ + dismissalMessageHTML: String + id: ID! -"""Ordering options for repository connections""" -input RepositoryOrder { - """The field to order repositories by.""" - field: RepositoryOrderField! + """ + Identifies the previous state of the review with the 'review_dismissed' event. + """ + previousReviewState: PullRequestReviewState! + + """PullRequest referenced by event.""" + pullRequest: PullRequest! + + """Identifies the commit which caused the review to become stale.""" + pullRequestCommit: PullRequestCommit + + """The HTTP path for this review dismissed event.""" + resourcePath: URI! + + """Identifies the review associated with the 'review_dismissed' event.""" + review: PullRequestReview - """The ordering direction.""" - direction: OrderDirection! + """The HTTP URL for this review dismissed event.""" + url: URI! } -"""Properties by which repository connections can be ordered.""" -enum RepositoryOrderField { - """Order repositories by creation time""" - CREATED_AT +"""A request for a user to review a pull request.""" +type ReviewRequest implements Node { + """Identifies the primary key from the database.""" + databaseId: Int + id: ID! - """Order repositories by update time""" - UPDATED_AT + """Identifies the pull request associated with this review request.""" + pullRequest: PullRequest! - """Order repositories by push time""" - PUSHED_AT + """The reviewer that is requested.""" + requestedReviewer: RequestedReviewer +} - """Order repositories by name""" - NAME +"""The connection type for ReviewRequest.""" +type ReviewRequestConnection { + """A list of edges.""" + edges: [ReviewRequestEdge] - """Order repositories by number of stargazers""" - STARGAZERS + """A list of nodes.""" + nodes: [ReviewRequest] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""Represents an owner of a Repository.""" -interface RepositoryOwner { - """A URL pointing to the owner's public avatar.""" - avatarUrl( - """The size of the resulting square image.""" - size: Int - ): URI! +"""Represents an 'review_requested' event on a given pull request.""" +type ReviewRequestedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor + + """Identifies the date and time when the object was created.""" + createdAt: DateTime! id: ID! - """The username used to login.""" - login: String! + """PullRequest referenced by event.""" + pullRequest: PullRequest! - """A list of repositories that the user owns.""" - repositories( - """If non-null, filters repositories according to privacy""" - privacy: RepositoryPrivacy + """Identifies the reviewer whose review was requested.""" + requestedReviewer: RequestedReviewer +} - """Ordering options for repositories returned from the connection""" - orderBy: RepositoryOrder +"""An edge in a connection.""" +type ReviewRequestEdge { + """A cursor for use in pagination.""" + cursor: String! - """ - Array of viewer's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - current viewer owns. - """ - affiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] + """The item at the end of the edge.""" + node: ReviewRequest +} - """ - Array of owner's affiliation options for repositories returned from the - connection. For example, OWNER will include only repositories that the - organization or user being viewed owns. - """ - ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR] +"""Represents an 'review_request_removed' event on a given pull request.""" +type ReviewRequestRemovedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor - """ - If non-null, filters repositories according to whether they have been locked - """ - isLocked: Boolean + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! - """Returns the elements in the list that come after the specified cursor.""" - after: String + """PullRequest referenced by event.""" + pullRequest: PullRequest! - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """Identifies the reviewer whose review request was removed.""" + requestedReviewer: RequestedReviewer +} - """Returns the first _n_ elements from the list.""" - first: Int +""" +A hovercard context with a message describing the current code review state of the pull +request. - """Returns the last _n_ elements from the list.""" - last: Int +""" +type ReviewStatusHovercardContext implements HovercardContext { + """A string describing this context""" + message: String! - """ - If non-null, filters repositories according to whether they are forks of another repository - """ - isFork: Boolean - ): RepositoryConnection! + """An octicon to accompany this context""" + octicon: String! +} - """Find Repository.""" - repository( - """Name of Repository to find.""" - name: String! - ): Repository +""" +The possible digest algorithms used to sign SAML requests for an identity provider. +""" +enum SamlDigestAlgorithm { + """SHA1""" + SHA1 - """The HTTP URL for the owner.""" - resourcePath: URI! + """SHA256""" + SHA256 - """The HTTP URL for the owner.""" - url: URI! -} + """SHA384""" + SHA384 -"""The access level to a repository""" -enum RepositoryPermission { - """ - Can read, clone, and push to this repository. Can also manage issues, pull - requests, and repository settings, including adding collaborators - """ - ADMIN + """SHA512""" + SHA512 +} - """ - Can read, clone, and push to this repository. They can also manage issues, pull requests, and some repository settings - """ - MAINTAIN +""" +The possible signature algorithms used to sign SAML requests for a Identity Provider. +""" +enum SamlSignatureAlgorithm { + """RSA-SHA1""" + RSA_SHA1 - """ - Can read, clone, and push to this repository. Can also manage issues and pull requests - """ - WRITE + """RSA-SHA256""" + RSA_SHA256 - """ - Can read and clone this repository. Can also manage issues and pull requests - """ - TRIAGE + """RSA-SHA384""" + RSA_SHA384 - """ - Can read and clone this repository. Can also open and comment on issues and pull requests - """ - READ + """RSA-SHA512""" + RSA_SHA512 } -"""The privacy of a repository""" -enum RepositoryPrivacy { - """Public""" - PUBLIC +"""A Saved Reply is text a user can use to reply quickly.""" +type SavedReply implements Node { + """The body of the saved reply.""" + body: String! - """Private""" - PRIVATE -} + """The saved reply body rendered to HTML.""" + bodyHTML: HTML! -"""A repository-topic connects a repository to a topic.""" -type RepositoryTopic implements Node & UniformResourceLocatable { + """Identifies the primary key from the database.""" + databaseId: Int id: ID! - """The HTTP path for this repository-topic.""" - resourcePath: URI! - - """The topic.""" - topic: Topic! + """The title of the saved reply.""" + title: String! - """The HTTP URL for this repository-topic.""" - url: URI! + """The user that saved this reply.""" + user: Actor } -"""The connection type for RepositoryTopic.""" -type RepositoryTopicConnection { +"""The connection type for SavedReply.""" +type SavedReplyConnection { """A list of edges.""" - edges: [RepositoryTopicEdge] + edges: [SavedReplyEdge] """A list of nodes.""" - nodes: [RepositoryTopic] + nodes: [SavedReply] """Information to aid in pagination.""" pageInfo: PageInfo! @@ -15784,286 +19008,312 @@ type RepositoryTopicConnection { } """An edge in a connection.""" -type RepositoryTopicEdge { +type SavedReplyEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: RepositoryTopic + node: SavedReply } -"""The repository's visibility level.""" -enum RepositoryVisibility { - """The repository is visible only to those with explicit access.""" - PRIVATE +"""Ordering options for saved reply connections.""" +input SavedReplyOrder { + """The field to order saved replies by.""" + field: SavedReplyOrderField! - """The repository is visible to everyone.""" - PUBLIC + """The ordering direction.""" + direction: OrderDirection! +} - """The repository is visible only to users in the same business.""" - INTERNAL +"""Properties by which saved reply connections can be ordered.""" +enum SavedReplyOrderField { + """Order saved reply by when they were updated.""" + UPDATED_AT } -"""Audit log entry for a repository_visibility_change.disable event.""" -type RepositoryVisibilityChangeDisableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { - """The action name""" - action: String! +"""The results of a search.""" +union SearchResultItem = Issue | PullRequest | Repository | User | Organization | MarketplaceListing | App - """The user who initiated the action""" - actor: AuditEntryActor +"""A list of results that matched against a search query.""" +type SearchResultItemConnection { + """The number of pieces of code that matched the search query.""" + codeCount: Int! - """The IP address of the actor""" - actorIp: String + """A list of edges.""" + edges: [SearchResultItemEdge] + + """The number of issues that matched the search query.""" + issueCount: Int! + + """A list of nodes.""" + nodes: [SearchResultItem] + + """Information to aid in pagination.""" + pageInfo: PageInfo! + + """The number of repositories that matched the search query.""" + repositoryCount: Int! + + """The number of users that matched the search query.""" + userCount: Int! + + """The number of wiki pages that matched the search query.""" + wikiCount: Int! +} + +"""An edge in a connection.""" +type SearchResultItemEdge { + """A cursor for use in pagination.""" + cursor: String! - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """The item at the end of the edge.""" + node: SearchResultItem - """The username of the user who initiated the action""" - actorLogin: String + """Text matches on the result found.""" + textMatches: [TextMatch] +} - """The HTTP path for the actor.""" - actorResourcePath: URI +"""Represents the individual results of a search.""" +enum SearchType { + """Returns results matching issues in repositories.""" + ISSUE - """The HTTP URL for the actor.""" - actorUrl: URI + """Returns results matching repositories.""" + REPOSITORY - """The time the action was initiated""" - createdAt: PreciseDateTime! + """Returns results matching users and organizations on GitHub.""" + USER +} - """The HTTP path for this enterprise.""" - enterpriseResourcePath: URI +"""A GitHub Security Advisory""" +type SecurityAdvisory implements Node { + """Identifies the primary key from the database.""" + databaseId: Int - """The slug of the enterprise.""" - enterpriseSlug: String + """This is a long plaintext description of the advisory""" + description: String! - """The HTTP URL for this enterprise.""" - enterpriseUrl: URI + """The GitHub Security Advisory ID""" + ghsaId: String! id: ID! - """The Organization associated with the Audit Entry.""" - organization: Organization - - """The name of the Organization.""" - organizationName: String + """A list of identifiers for this advisory""" + identifiers: [SecurityAdvisoryIdentifier!]! - """The HTTP path for the organization""" - organizationResourcePath: URI + """The organization that originated the advisory""" + origin: String! - """The HTTP URL for the organization""" - organizationUrl: URI + """When the advisory was published""" + publishedAt: DateTime! - """The user affected by the action""" - user: User + """A list of references for this advisory""" + references: [SecurityAdvisoryReference!]! - """ - For actions involving two users, the actor is the initiator and the user is the affected user. - """ - userLogin: String + """The severity of the advisory""" + severity: SecurityAdvisorySeverity! - """The HTTP path for the user.""" - userResourcePath: URI + """A short plaintext summary of the advisory""" + summary: String! - """The HTTP URL for the user.""" - userUrl: URI -} + """When the advisory was last updated""" + updatedAt: DateTime! -"""Audit log entry for a repository_visibility_change.enable event.""" -type RepositoryVisibilityChangeEnableAuditEntry implements Node & AuditEntry & EnterpriseAuditEntryData & OrganizationAuditEntryData { - """The action name""" - action: String! + """Vulnerabilities associated with this Advisory""" + vulnerabilities( + """Ordering options for the returned topics.""" + orderBy: SecurityVulnerabilityOrder = {field: UPDATED_AT, direction: DESC} - """The user who initiated the action""" - actor: AuditEntryActor + """An ecosystem to filter vulnerabilities by.""" + ecosystem: SecurityAdvisoryEcosystem - """The IP address of the actor""" - actorIp: String + """A package name to filter vulnerabilities by.""" + package: String - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """A list of severities to filter vulnerabilities by.""" + severities: [SecurityAdvisorySeverity!] - """The username of the user who initiated the action""" - actorLogin: String + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The HTTP path for the actor.""" - actorResourcePath: URI + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The HTTP URL for the actor.""" - actorUrl: URI + """Returns the first _n_ elements from the list.""" + first: Int - """The time the action was initiated""" - createdAt: PreciseDateTime! + """Returns the last _n_ elements from the list.""" + last: Int + ): SecurityVulnerabilityConnection! - """The HTTP path for this enterprise.""" - enterpriseResourcePath: URI + """When the advisory was withdrawn, if it has been withdrawn""" + withdrawnAt: DateTime +} - """The slug of the enterprise.""" - enterpriseSlug: String +"""The connection type for SecurityAdvisory.""" +type SecurityAdvisoryConnection { + """A list of edges.""" + edges: [SecurityAdvisoryEdge] - """The HTTP URL for this enterprise.""" - enterpriseUrl: URI - id: ID! + """A list of nodes.""" + nodes: [SecurityAdvisory] - """The Organization associated with the Audit Entry.""" - organization: Organization + """Information to aid in pagination.""" + pageInfo: PageInfo! - """The name of the Organization.""" - organizationName: String + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """The HTTP path for the organization""" - organizationResourcePath: URI +"""The possible ecosystems of a security vulnerability's package.""" +enum SecurityAdvisoryEcosystem { + """Ruby gems hosted at RubyGems.org""" + RUBYGEMS - """The HTTP URL for the organization""" - organizationUrl: URI + """JavaScript packages hosted at npmjs.com""" + NPM - """The user affected by the action""" - user: User + """Python packages hosted at PyPI.org""" + PIP - """ - For actions involving two users, the actor is the initiator and the user is the affected user. - """ - userLogin: String + """Java artifacts hosted at the Maven central repository""" + MAVEN - """The HTTP path for the user.""" - userResourcePath: URI + """.NET packages hosted at the NuGet Gallery""" + NUGET - """The HTTP URL for the user.""" - userUrl: URI + """PHP packages hosted at packagist.org""" + COMPOSER } -"""The possible states that can be requested when creating a check run.""" -enum RequestableCheckStatusState { - """The check suite or run has been queued.""" - QUEUED - - """The check suite or run is in progress.""" - IN_PROGRESS +"""An edge in a connection.""" +type SecurityAdvisoryEdge { + """A cursor for use in pagination.""" + cursor: String! - """The check suite or run has been completed.""" - COMPLETED + """The item at the end of the edge.""" + node: SecurityAdvisory } -"""Types that can be requested reviewers.""" -union RequestedReviewer = User | Team | Mannequin +"""A GitHub Security Advisory Identifier""" +type SecurityAdvisoryIdentifier { + """The identifier type, e.g. GHSA, CVE""" + type: String! -"""Autogenerated input type of RequestReviews""" -input RequestReviewsInput { - """The Node ID of the pull request to modify.""" - pullRequestId: ID! + """The identifier""" + value: String! +} - """The Node IDs of the user to request.""" - userIds: [ID!] +"""An advisory identifier to filter results on.""" +input SecurityAdvisoryIdentifierFilter { + """The identifier type.""" + type: SecurityAdvisoryIdentifierType! - """The Node IDs of the team to request.""" - teamIds: [ID!] + """The identifier string. Supports exact or partial matching.""" + value: String! +} - """Add users to the set rather than replace.""" - union: Boolean +"""Identifier formats available for advisories.""" +enum SecurityAdvisoryIdentifierType { + """Common Vulnerabilities and Exposures Identifier.""" + CVE - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """GitHub Security Advisory ID.""" + GHSA } -"""Autogenerated return type of RequestReviews""" -type RequestReviewsPayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String - - """The pull request that is getting requests.""" - pullRequest: PullRequest +"""Ordering options for security advisory connections""" +input SecurityAdvisoryOrder { + """The field to order security advisories by.""" + field: SecurityAdvisoryOrderField! - """The edge from the pull request to the requested reviewers.""" - requestedReviewersEdge: UserEdge + """The ordering direction.""" + direction: OrderDirection! } -"""Autogenerated input type of RerequestCheckSuite""" -input RerequestCheckSuiteInput { - """The Node ID of the repository.""" - repositoryId: ID! +"""Properties by which security advisory connections can be ordered.""" +enum SecurityAdvisoryOrderField { + """Order advisories by publication time""" + PUBLISHED_AT - """The Node ID of the check suite.""" - checkSuiteId: ID! + """Order advisories by update time""" + UPDATED_AT +} - """A unique identifier for the client performing the mutation.""" - clientMutationId: String +"""An individual package""" +type SecurityAdvisoryPackage { + """The ecosystem the package belongs to, e.g. RUBYGEMS, NPM""" + ecosystem: SecurityAdvisoryEcosystem! + + """The package name""" + name: String! } -"""Autogenerated return type of RerequestCheckSuite""" -type RerequestCheckSuitePayload { - """The requested check suite.""" - checkSuite: CheckSuite +"""An individual package version""" +type SecurityAdvisoryPackageVersion { + """The package name or version""" + identifier: String! +} - """A unique identifier for the client performing the mutation.""" - clientMutationId: String +"""A GitHub Security Advisory Reference""" +type SecurityAdvisoryReference { + """A publicly accessible reference""" + url: URI! } -"""Autogenerated input type of ResolveReviewThread""" -input ResolveReviewThreadInput { - """The ID of the thread to resolve""" - threadId: ID! +"""Severity of the vulnerability.""" +enum SecurityAdvisorySeverity { + """Low.""" + LOW - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """Moderate.""" + MODERATE -"""Autogenerated return type of ResolveReviewThread""" -type ResolveReviewThreadPayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """High.""" + HIGH - """The thread to resolve.""" - thread: PullRequestReviewThread + """Critical.""" + CRITICAL } -"""Represents a private contribution a user made on GitHub.""" -type RestrictedContribution implements Contribution { - """ - Whether this contribution is associated with a record you do not have access to. For - example, your own 'first issue' contribution may have been made on a repository you can no - longer access. - - """ - isRestricted: Boolean! - - """When this contribution was made.""" - occurredAt: DateTime! +"""An individual vulnerability within an Advisory""" +type SecurityVulnerability { + """The Advisory associated with this Vulnerability""" + advisory: SecurityAdvisory! - """The HTTP path for this contribution.""" - resourcePath: URI! + """The first version containing a fix for the vulnerability""" + firstPatchedVersion: SecurityAdvisoryPackageVersion - """The HTTP URL for this contribution.""" - url: URI! + """A description of the vulnerable package""" + package: SecurityAdvisoryPackage! - """ - The user who made this contribution. - - """ - user: User! -} + """The severity of the vulnerability within this package""" + severity: SecurityAdvisorySeverity! -""" -A team or user who has the ability to dismiss a review on a protected branch. -""" -type ReviewDismissalAllowance implements Node { - """The actor that can dismiss.""" - actor: ReviewDismissalAllowanceActor + """When the vulnerability was last updated""" + updatedAt: DateTime! """ - Identifies the branch protection rule associated with the allowed user or team. + A string that describes the vulnerable package versions. + This string follows a basic syntax with a few forms. + + `= 0.2.0` denotes a single vulnerable version. + + `<= 1.0.8` denotes a version range up to and including the specified version + + `< 0.1.11` denotes a version range up to, but excluding, the specified version + + `>= 4.3.0, < 4.3.5` denotes a version range with a known minimum and maximum version. + + `>= 0.0.1` denotes a version range with a known minimum, but no known maximum + """ - branchProtectionRule: BranchProtectionRule - id: ID! + vulnerableVersionRange: String! } -"""Types that can be an actor.""" -union ReviewDismissalAllowanceActor = User | Team - -"""The connection type for ReviewDismissalAllowance.""" -type ReviewDismissalAllowanceConnection { +"""The connection type for SecurityVulnerability.""" +type SecurityVulnerabilityConnection { """A list of edges.""" - edges: [ReviewDismissalAllowanceEdge] + edges: [SecurityVulnerabilityEdge] """A list of nodes.""" - nodes: [ReviewDismissalAllowance] + nodes: [SecurityVulnerability] """Information to aid in pagination.""" pageInfo: PageInfo! @@ -16073,154 +19323,135 @@ type ReviewDismissalAllowanceConnection { } """An edge in a connection.""" -type ReviewDismissalAllowanceEdge { +type SecurityVulnerabilityEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: ReviewDismissalAllowance + node: SecurityVulnerability } -""" -Represents a 'review_dismissed' event on a given issue or pull request. -""" -type ReviewDismissedEvent implements Node & UniformResourceLocatable { - """Identifies the actor who performed the event.""" - actor: Actor +"""Ordering options for security vulnerability connections""" +input SecurityVulnerabilityOrder { + """The field to order security vulnerabilities by.""" + field: SecurityVulnerabilityOrderField! - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """The ordering direction.""" + direction: OrderDirection! +} - """Identifies the primary key from the database.""" - databaseId: Int +"""Properties by which security vulnerability connections can be ordered.""" +enum SecurityVulnerabilityOrderField { + """Order vulnerability by update time""" + UPDATED_AT +} - """ - Identifies the optional message associated with the 'review_dismissed' event. - """ - dismissalMessage: String +"""Represents an S/MIME signature on a Commit or Tag.""" +type SmimeSignature implements GitSignature { + """Email used to sign this object.""" + email: String! - """ - Identifies the optional message associated with the event, rendered to HTML. - """ - dismissalMessageHTML: String - id: ID! + """True if the signature is valid and verified by GitHub.""" + isValid: Boolean! """ - Identifies the previous state of the review with the 'review_dismissed' event. + Payload for GPG signing object. Raw ODB object without the signature header. """ - previousReviewState: PullRequestReviewState! - - """PullRequest referenced by event.""" - pullRequest: PullRequest! - - """Identifies the commit which caused the review to become stale.""" - pullRequestCommit: PullRequestCommit - - """The HTTP path for this review dismissed event.""" - resourcePath: URI! - - """Identifies the review associated with the 'review_dismissed' event.""" - review: PullRequestReview + payload: String! - """The HTTP URL for this review dismissed event.""" - url: URI! -} + """ASCII-armored signature header from object.""" + signature: String! -"""A request for a user to review a pull request.""" -type ReviewRequest implements Node { - """Identifies the primary key from the database.""" - databaseId: Int - id: ID! + """GitHub user corresponding to the email signing this commit.""" + signer: User - """Identifies the pull request associated with this review request.""" - pullRequest: PullRequest! + """ + The state of this signature. `VALID` if signature is valid and verified by + GitHub, otherwise represents reason why signature is considered invalid. + """ + state: GitSignatureState! - """The reviewer that is requested.""" - requestedReviewer: RequestedReviewer + """True if the signature was made with GitHub's signing key.""" + wasSignedByGitHub: Boolean! } -"""The connection type for ReviewRequest.""" -type ReviewRequestConnection { - """A list of edges.""" - edges: [ReviewRequestEdge] - - """A list of nodes.""" - nodes: [ReviewRequest] - - """Information to aid in pagination.""" - pageInfo: PageInfo! - - """Identifies the total count of items in the connection.""" - totalCount: Int! -} +"""Entities that can be sponsored through GitHub Sponsors""" +interface Sponsorable { + """This object's sponsorships as the maintainer.""" + sponsorshipsAsMaintainer( + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""Represents an 'review_requested' event on a given pull request.""" -type ReviewRequestedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! + """Returns the first _n_ elements from the list.""" + first: Int - """PullRequest referenced by event.""" - pullRequest: PullRequest! + """Returns the last _n_ elements from the list.""" + last: Int - """Identifies the reviewer whose review was requested.""" - requestedReviewer: RequestedReviewer -} + """Whether or not to include private sponsorships in the result set""" + includePrivate: Boolean = false -"""An edge in a connection.""" -type ReviewRequestEdge { - """A cursor for use in pagination.""" - cursor: String! + """ + Ordering options for sponsorships returned from this connection. If left + blank, the sponsorships will be ordered based on relevancy to the viewer. + """ + orderBy: SponsorshipOrder + ): SponsorshipConnection! - """The item at the end of the edge.""" - node: ReviewRequest -} + """This object's sponsorships as the sponsor.""" + sponsorshipsAsSponsor( + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""Represents an 'review_request_removed' event on a given pull request.""" -type ReviewRequestRemovedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! + """Returns the first _n_ elements from the list.""" + first: Int - """PullRequest referenced by event.""" - pullRequest: PullRequest! + """Returns the last _n_ elements from the list.""" + last: Int - """Identifies the reviewer whose review request was removed.""" - requestedReviewer: RequestedReviewer + """ + Ordering options for sponsorships returned from this connection. If left + blank, the sponsorships will be ordered based on relevancy to the viewer. + """ + orderBy: SponsorshipOrder + ): SponsorshipConnection! } -"""A Saved Reply is text a user can use to reply quickly.""" -type SavedReply implements Node { - """The body of the saved reply.""" - body: String! - - """The saved reply body rendered to HTML.""" - bodyHTML: HTML! - - """Identifies the primary key from the database.""" - databaseId: Int +"""A sponsorship relationship between a sponsor and a maintainer""" +type Sponsorship implements Node { + """Identifies the date and time when the object was created.""" + createdAt: DateTime! id: ID! - """The title of the saved reply.""" - title: String! + """The entity that is being sponsored""" + maintainer: User! - """The user that saved this reply.""" - user: Actor + """The privacy level for this sponsorship.""" + privacyLevel: SponsorshipPrivacy! + + """ + The entity that is sponsoring. Returns null if the sponsorship is private + """ + sponsor: User } -"""The connection type for SavedReply.""" -type SavedReplyConnection { +"""The connection type for Sponsorship.""" +type SponsorshipConnection { """A list of edges.""" - edges: [SavedReplyEdge] + edges: [SponsorshipEdge] """A list of nodes.""" - nodes: [SavedReply] + nodes: [Sponsorship] """Information to aid in pagination.""" pageInfo: PageInfo! @@ -16230,130 +19461,94 @@ type SavedReplyConnection { } """An edge in a connection.""" -type SavedReplyEdge { +type SponsorshipEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: SavedReply + node: Sponsorship } -"""Ordering options for saved reply connections.""" -input SavedReplyOrder { - """The field to order saved replies by.""" - field: SavedReplyOrderField! - +"""Ordering options for sponsorship connections.""" +input SponsorshipOrder { """The ordering direction.""" direction: OrderDirection! } -"""Properties by which saved reply connections can be ordered.""" -enum SavedReplyOrderField { - """Order saved reply by when they were updated.""" - UPDATED_AT +"""The privacy of a sponsorship""" +enum SponsorshipPrivacy { + """Public""" + PUBLIC + + """Private""" + PRIVATE } -"""The results of a search.""" -union SearchResultItem = Issue | PullRequest | Repository | User | Organization | MarketplaceListing | App +"""A GitHub Sponsors listing.""" +type SponsorsListing implements Node { + """The full description of the listing.""" + fullDescription: String! -"""A list of results that matched against a search query.""" -type SearchResultItemConnection { - """The number of pieces of code that matched the search query.""" - codeCount: Int! + """The full description of the listing rendered to HTML.""" + fullDescriptionHTML: HTML! + id: ID! - """A list of edges.""" - edges: [SearchResultItemEdge] + """The listing's full name.""" + name: String! - """The number of issues that matched the search query.""" - issueCount: Int! + """The short description of the listing.""" + shortDescription: String! + + """The short name of the listing.""" + slug: String! +} + +"""The connection type for User.""" +type StargazerConnection { + """A list of edges.""" + edges: [StargazerEdge] """A list of nodes.""" - nodes: [SearchResultItem] + nodes: [User] """Information to aid in pagination.""" pageInfo: PageInfo! - """The number of repositories that matched the search query.""" - repositoryCount: Int! - - """The number of users that matched the search query.""" - userCount: Int! - - """The number of wiki pages that matched the search query.""" - wikiCount: Int! + """Identifies the total count of items in the connection.""" + totalCount: Int! } -"""An edge in a connection.""" -type SearchResultItemEdge { +"""Represents a user that's starred a repository.""" +type StargazerEdge { """A cursor for use in pagination.""" cursor: String! + node: User! - """The item at the end of the edge.""" - node: SearchResultItem - - """Text matches on the result found.""" - textMatches: [TextMatch] + """Identifies when the item was starred.""" + starredAt: DateTime! } -"""Represents the individual results of a search.""" -enum SearchType { - """Returns results matching issues in repositories.""" - ISSUE - - """Returns results matching repositories.""" - REPOSITORY +"""Ways in which star connections can be ordered.""" +input StarOrder { + """The field in which to order nodes by.""" + field: StarOrderField! - """Returns results matching users and organizations on GitHub.""" - USER + """The direction in which to order nodes.""" + direction: OrderDirection! } -"""A GitHub Security Advisory""" -type SecurityAdvisory implements Node { - """Identifies the primary key from the database.""" - databaseId: Int - - """This is a long plaintext description of the advisory""" - description: String! +"""Properties by which star connections can be ordered.""" +enum StarOrderField { + """Allows ordering a list of stars by when they were created.""" + STARRED_AT +} - """The GitHub Security Advisory ID""" - ghsaId: String! +"""Things that can be starred.""" +interface Starrable { id: ID! - """A list of identifiers for this advisory""" - identifiers: [SecurityAdvisoryIdentifier!]! - - """The organization that originated the advisory""" - origin: String! - - """When the advisory was published""" - publishedAt: DateTime! - - """A list of references for this advisory""" - references: [SecurityAdvisoryReference!]! - - """The severity of the advisory""" - severity: SecurityAdvisorySeverity! - - """A short plaintext summary of the advisory""" - summary: String! - - """When the advisory was last updated""" - updatedAt: DateTime! - - """Vulnerabilities associated with this Advisory""" - vulnerabilities( - """Ordering options for the returned topics.""" - orderBy: SecurityVulnerabilityOrder - - """An ecosystem to filter vulnerabilities by.""" - ecosystem: SecurityAdvisoryEcosystem - - """A package name to filter vulnerabilities by.""" - package: String - - """A list of severities to filter vulnerabilities by.""" - severities: [SecurityAdvisorySeverity!] - + """A list of users who have starred this starrable.""" + stargazers( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -16367,19 +19562,24 @@ type SecurityAdvisory implements Node { """Returns the last _n_ elements from the list.""" last: Int - ): SecurityVulnerabilityConnection! - """When the advisory was withdrawn, if it has been withdrawn""" - withdrawnAt: DateTime + """Order for connection""" + orderBy: StarOrder + ): StargazerConnection! + + """ + Returns a boolean indicating whether the viewing user has starred this starrable. + """ + viewerHasStarred: Boolean! } -"""The connection type for SecurityAdvisory.""" -type SecurityAdvisoryConnection { +"""The connection type for Repository.""" +type StarredRepositoryConnection { """A list of edges.""" - edges: [SecurityAdvisoryEdge] + edges: [StarredRepositoryEdge] """A list of nodes.""" - nodes: [SecurityAdvisory] + nodes: [Repository] """Information to aid in pagination.""" pageInfo: PageInfo! @@ -16388,236 +19588,231 @@ type SecurityAdvisoryConnection { totalCount: Int! } -"""The possible ecosystems of a security vulnerability's package.""" -enum SecurityAdvisoryEcosystem { - """Ruby gems hosted at RubyGems.org""" - RUBYGEMS - - """JavaScript packages hosted at npmjs.com""" - NPM - - """Python packages hosted at PyPI.org""" - PIP - - """Java artifacts hosted at the Maven central repository""" - MAVEN - - """.NET packages hosted at the NuGet Gallery""" - NUGET -} - -"""An edge in a connection.""" -type SecurityAdvisoryEdge { +"""Represents a starred repository.""" +type StarredRepositoryEdge { """A cursor for use in pagination.""" cursor: String! + node: Repository! - """The item at the end of the edge.""" - node: SecurityAdvisory + """Identifies when the item was starred.""" + starredAt: DateTime! } -"""A GitHub Security Advisory Identifier""" -type SecurityAdvisoryIdentifier { - """The identifier type, e.g. GHSA, CVE""" - type: String! +"""Represents a commit status.""" +type Status implements Node { + """The commit this status is attached to.""" + commit: Commit - """The identifier""" - value: String! + """Looks up an individual status context by context name.""" + context( + """The context name.""" + name: String! + ): StatusContext + + """The individual status contexts for this commit.""" + contexts: [StatusContext!]! + id: ID! + + """The combined commit status.""" + state: StatusState! } -"""An advisory identifier to filter results on.""" -input SecurityAdvisoryIdentifierFilter { - """The identifier type.""" - type: SecurityAdvisoryIdentifierType! +"""Represents an individual commit status context""" +type StatusContext implements Node { + """ + The avatar of the OAuth application or the user that created the status + """ + avatarUrl( + """The size of the resulting square image.""" + size: Int = 40 + ): URI - """The identifier string. Supports exact or partial matching.""" - value: String! -} + """This commit this status context is attached to.""" + commit: Commit -"""Identifier formats available for advisories.""" -enum SecurityAdvisoryIdentifierType { - """Common Vulnerabilities and Exposures Identifier.""" - CVE + """The name of this status context.""" + context: String! - """GitHub Security Advisory ID.""" - GHSA -} + """Identifies the date and time when the object was created.""" + createdAt: DateTime! -"""Ordering options for security advisory connections""" -input SecurityAdvisoryOrder { - """The field to order security advisories by.""" - field: SecurityAdvisoryOrderField! + """The actor who created this status context.""" + creator: Actor - """The ordering direction.""" - direction: OrderDirection! -} + """The description for this status context.""" + description: String + id: ID! -"""Properties by which security advisory connections can be ordered.""" -enum SecurityAdvisoryOrderField { - """Order advisories by publication time""" - PUBLISHED_AT + """The state of this status context.""" + state: StatusState! - """Order advisories by update time""" - UPDATED_AT + """The URL for this status context.""" + targetUrl: URI } -"""An individual package""" -type SecurityAdvisoryPackage { - """The ecosystem the package belongs to, e.g. RUBYGEMS, NPM""" - ecosystem: SecurityAdvisoryEcosystem! +"""The possible commit status states.""" +enum StatusState { + """Status is expected.""" + EXPECTED - """The package name""" - name: String! -} + """Status is errored.""" + ERROR -"""An individual package version""" -type SecurityAdvisoryPackageVersion { - """The package name or version""" - identifier: String! -} + """Status is failing.""" + FAILURE -"""A GitHub Security Advisory Reference""" -type SecurityAdvisoryReference { - """A publicly accessible reference""" - url: URI! + """Status is pending.""" + PENDING + + """Status is successful.""" + SUCCESS } -"""Severity of the vulnerability.""" -enum SecurityAdvisorySeverity { - """Low.""" - LOW +"""Autogenerated input type of SubmitPullRequestReview""" +input SubmitPullRequestReviewInput { + """The Pull Request Review ID to submit.""" + pullRequestReviewId: ID! - """Moderate.""" - MODERATE + """The event to send to the Pull Request Review.""" + event: PullRequestReviewEvent! - """High.""" - HIGH + """The text field to set on the Pull Request Review.""" + body: String - """Critical.""" - CRITICAL + """A unique identifier for the client performing the mutation.""" + clientMutationId: String } -"""An individual vulnerability within an Advisory""" -type SecurityVulnerability { - """The Advisory associated with this Vulnerability""" - advisory: SecurityAdvisory! - - """The first version containing a fix for the vulnerability""" - firstPatchedVersion: SecurityAdvisoryPackageVersion +"""Autogenerated return type of SubmitPullRequestReview""" +type SubmitPullRequestReviewPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String - """A description of the vulnerable package""" - package: SecurityAdvisoryPackage! + """The submitted pull request review.""" + pullRequestReview: PullRequestReview +} - """The severity of the vulnerability within this package""" - severity: SecurityAdvisorySeverity! +"""Entities that can be subscribed to for web and email notifications.""" +interface Subscribable { + id: ID! - """When the vulnerability was last updated""" - updatedAt: DateTime! + """ + Check if the viewer is able to change their subscription status for the repository. + """ + viewerCanSubscribe: Boolean! """ - A string that describes the vulnerable package versions. - This string follows a basic syntax with a few forms. - + `= 0.2.0` denotes a single vulnerable version. - + `<= 1.0.8` denotes a version range up to and including the specified version - + `< 0.1.11` denotes a version range up to, but excluding, the specified version - + `>= 4.3.0, < 4.3.5` denotes a version range with a known minimum and maximum version. - + `>= 0.0.1` denotes a version range with a known minimum, but no known maximum - + Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. """ - vulnerableVersionRange: String! + viewerSubscription: SubscriptionState } -"""The connection type for SecurityVulnerability.""" -type SecurityVulnerabilityConnection { - """A list of edges.""" - edges: [SecurityVulnerabilityEdge] - - """A list of nodes.""" - nodes: [SecurityVulnerability] +"""Represents a 'subscribed' event on a given `Subscribable`.""" +type SubscribedEvent implements Node { + """Identifies the actor who performed the event.""" + actor: Actor - """Information to aid in pagination.""" - pageInfo: PageInfo! + """Identifies the date and time when the object was created.""" + createdAt: DateTime! + id: ID! - """Identifies the total count of items in the connection.""" - totalCount: Int! + """Object referenced by event.""" + subscribable: Subscribable! } -"""An edge in a connection.""" -type SecurityVulnerabilityEdge { - """A cursor for use in pagination.""" - cursor: String! +"""The possible states of a subscription.""" +enum SubscriptionState { + """The User is only notified when participating or @mentioned.""" + UNSUBSCRIBED - """The item at the end of the edge.""" - node: SecurityVulnerability + """The User is notified of all conversations.""" + SUBSCRIBED + + """The User is never notified.""" + IGNORED } -"""Ordering options for security vulnerability connections""" -input SecurityVulnerabilityOrder { - """The field to order security vulnerabilities by.""" - field: SecurityVulnerabilityOrderField! +""" +A suggestion to review a pull request based on a user's commit history and review comments. +""" +type SuggestedReviewer { + """Is this suggestion based on past commits?""" + isAuthor: Boolean! - """The ordering direction.""" - direction: OrderDirection! -} + """Is this suggestion based on past review comments?""" + isCommenter: Boolean! -"""Properties by which security vulnerability connections can be ordered.""" -enum SecurityVulnerabilityOrderField { - """Order vulnerability by update time""" - UPDATED_AT + """Identifies the user suggested to review the pull request.""" + reviewer: User! } -"""Autogenerated input type of SetEnterpriseIdentityProvider""" -input SetEnterpriseIdentityProviderInput { - """The ID of the enterprise on which to set an identity provider.""" - enterpriseId: ID! +"""Represents a Git tag.""" +type Tag implements Node & GitObject { + """An abbreviated version of the Git object ID""" + abbreviatedOid: String! - """The URL endpoint for the identity provider's SAML SSO.""" - ssoUrl: URI! + """The HTTP path for this Git object""" + commitResourcePath: URI! - """The Issuer Entity ID for the SAML identity provider""" - issuer: String + """The HTTP URL for this Git object""" + commitUrl: URI! + id: ID! - """ - The x509 certificate used by the identity provider to sign assertions and responses. - """ - idpCertificate: String! + """The Git tag message.""" + message: String - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """The Git tag name.""" + name: String! + + """The Git object ID""" + oid: GitObjectID! + + """The Repository the Git object belongs to""" + repository: Repository! + + """Details about the tag author.""" + tagger: GitActor + + """The Git object the tag points to.""" + target: GitObject! } -"""Represents an S/MIME signature on a Commit or Tag.""" -type SmimeSignature implements GitSignature { - """Email used to sign this object.""" - email: String! +"""A team of users in an organization.""" +type Team implements Node & Subscribable & MemberStatusable { + """A list of teams that are ancestors of this team.""" + ancestors( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """True if the signature is valid and verified by GitHub.""" - isValid: Boolean! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """ - Payload for GPG signing object. Raw ODB object without the signature header. - """ - payload: String! + """Returns the first _n_ elements from the list.""" + first: Int - """ASCII-armored signature header from object.""" - signature: String! + """Returns the last _n_ elements from the list.""" + last: Int + ): TeamConnection! - """GitHub user corresponding to the email signing this commit.""" - signer: User + """A URL pointing to the team's avatar.""" + avatarUrl( + """The size in pixels of the resulting square image.""" + size: Int = 400 + ): URI + + """List of child teams belonging to this team""" + childTeams( + """Order for connection""" + orderBy: TeamOrder - """ - The state of this signature. `VALID` if signature is valid and verified by - GitHub, otherwise represents reason why signature is considered invalid. - """ - state: GitSignatureState! + """User logins to filter by""" + userLogins: [String!] - """True if the signature was made with GitHub's signing key.""" - wasSignedByGitHub: Boolean! -} + """Whether to list immediate child teams or all descendant child teams.""" + immediateOnly: Boolean = true -"""Entities that can be sponsored through GitHub Sponsors""" -interface Sponsorable { - """This object's sponsorships as the maintainer.""" - sponsorshipsAsMaintainer( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -16631,19 +19826,25 @@ interface Sponsorable { """Returns the last _n_ elements from the list.""" last: Int + ): TeamConnection! - """Whether or not to include private sponsorships in the result set""" - includePrivate: Boolean = false + """The slug corresponding to the organization and team.""" + combinedSlug: String! - """ - Ordering options for sponsorships returned from this connection. If left - blank, the sponsorships will be ordered based on relevancy to the viewer. - """ - orderBy: SponsorshipOrder - ): SponsorshipConnection! + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """This object's sponsorships as the sponsor.""" - sponsorshipsAsSponsor( + """The description of the team.""" + description: String + + """Find a team discussion by its number.""" + discussion( + """The sequence number of the discussion to find.""" + number: Int! + ): TeamDiscussion + + """A list of team discussions.""" + discussions( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -16659,138 +19860,121 @@ interface Sponsorable { last: Int """ - Ordering options for sponsorships returned from this connection. If left - blank, the sponsorships will be ordered based on relevancy to the viewer. + If provided, filters discussions according to whether or not they are pinned. """ - orderBy: SponsorshipOrder - ): SponsorshipConnection! -} + isPinned: Boolean -"""Represents a sponsor.""" -type SponsorEdge { - """A cursor for use in pagination.""" - cursor: String! + """Order for connection""" + orderBy: TeamDiscussionOrder + ): TeamDiscussionConnection! - """The item at the end of the edge.""" - node: User -} + """The HTTP path for team discussions""" + discussionsResourcePath: URI! -"""A sponsorship relationship between a sponsor and a maintainer""" -type Sponsorship implements Node { - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """The HTTP URL for team discussions""" + discussionsUrl: URI! + + """The HTTP path for editing this team""" + editTeamResourcePath: URI! + + """The HTTP URL for editing this team""" + editTeamUrl: URI! id: ID! - """The entity that is being sponsored""" - maintainer: User! + """A list of pending invitations for users to this team""" + invitations( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The privacy level for this sponsorship.""" - privacyLevel: SponsorshipPrivacy! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """ - The entity that is sponsoring. Returns null if the sponsorship is private - """ - sponsor: User -} + """Returns the first _n_ elements from the list.""" + first: Int -"""The connection type for Sponsorship.""" -type SponsorshipConnection { - """A list of edges.""" - edges: [SponsorshipEdge] + """Returns the last _n_ elements from the list.""" + last: Int + ): OrganizationInvitationConnection - """A list of nodes.""" - nodes: [Sponsorship] + """ + Get the status messages members of this entity have set that are either public or visible only to the organization. + """ + memberStatuses( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """Information to aid in pagination.""" - pageInfo: PageInfo! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """Returns the first _n_ elements from the list.""" + first: Int -"""An edge in a connection.""" -type SponsorshipEdge { - """A cursor for use in pagination.""" - cursor: String! + """Returns the last _n_ elements from the list.""" + last: Int - """The item at the end of the edge.""" - node: Sponsorship -} + """Ordering options for user statuses returned from the connection.""" + orderBy: UserStatusOrder = {field: UPDATED_AT, direction: DESC} + ): UserStatusConnection! -"""Ordering options for sponsorship connections.""" -input SponsorshipOrder { - """The ordering direction.""" - direction: OrderDirection! -} + """A list of users who are members of this team.""" + members( + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""The privacy of a sponsorship""" -enum SponsorshipPrivacy { - """Public""" - PUBLIC + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """Private""" - PRIVATE -} + """Returns the first _n_ elements from the list.""" + first: Int -"""A GitHub Sponsors listing.""" -type SponsorsListing implements Node { - """The full description of the listing.""" - fullDescription: String! - id: ID! + """Returns the last _n_ elements from the list.""" + last: Int - """The short description of the listing.""" - shortDescription: String! + """The search string to look for.""" + query: String - """The short name of the listing.""" - slug: String! -} + """Filter by membership type""" + membership: TeamMembershipType = ALL -"""The connection type for User.""" -type StargazerConnection { - """A list of edges.""" - edges: [StargazerEdge] + """Filter by team member role""" + role: TeamMemberRole - """A list of nodes.""" - nodes: [User] + """Order for the connection.""" + orderBy: TeamMemberOrder + ): TeamMemberConnection! - """Information to aid in pagination.""" - pageInfo: PageInfo! + """The HTTP path for the team' members""" + membersResourcePath: URI! - """Identifies the total count of items in the connection.""" - totalCount: Int! -} + """The HTTP URL for the team' members""" + membersUrl: URI! -"""Represents a user that's starred a repository.""" -type StargazerEdge { - """A cursor for use in pagination.""" - cursor: String! - node: User! + """The name of the team.""" + name: String! - """Identifies when the item was starred.""" - starredAt: DateTime! -} + """The HTTP path creating a new team""" + newTeamResourcePath: URI! -"""Ways in which star connections can be ordered.""" -input StarOrder { - """The field in which to order nodes by.""" - field: StarOrderField! + """The HTTP URL creating a new team""" + newTeamUrl: URI! - """The direction in which to order nodes.""" - direction: OrderDirection! -} + """The organization that owns this team.""" + organization: Organization! -"""Properties by which star connections can be ordered.""" -enum StarOrderField { - """Allows ordering a list of stars by when they were created.""" - STARRED_AT -} + """The parent team of the team.""" + parentTeam: Team -"""Things that can be starred.""" -interface Starrable { - id: ID! + """The level of privacy the team has.""" + privacy: TeamPrivacy! - """A list of users who have starred this starrable.""" - stargazers( + """A list of repositories this team has access to.""" + repositories( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -16805,391 +19989,355 @@ interface Starrable { """Returns the last _n_ elements from the list.""" last: Int - """Order for connection""" - orderBy: StarOrder - ): StargazerConnection! + """The search string to look for.""" + query: String - """ - Returns a boolean indicating whether the viewing user has starred this starrable. - """ - viewerHasStarred: Boolean! -} + """Order for the connection.""" + orderBy: TeamRepositoryOrder + ): TeamRepositoryConnection! -"""The connection type for Repository.""" -type StarredRepositoryConnection { - """A list of edges.""" - edges: [StarredRepositoryEdge] + """The HTTP path for this team's repositories""" + repositoriesResourcePath: URI! - """A list of nodes.""" - nodes: [Repository] + """The HTTP URL for this team's repositories""" + repositoriesUrl: URI! - """Information to aid in pagination.""" - pageInfo: PageInfo! + """The HTTP path for this team""" + resourcePath: URI! + + """The slug corresponding to the team.""" + slug: String! + + """The HTTP path for this team's teams""" + teamsResourcePath: URI! + + """The HTTP URL for this team's teams""" + teamsUrl: URI! + + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! + + """The HTTP URL for this team""" + url: URI! + + """Team is adminable by the viewer.""" + viewerCanAdminister: Boolean! + + """ + Check if the viewer is able to change their subscription status for the repository. + """ + viewerCanSubscribe: Boolean! - """Identifies the total count of items in the connection.""" - totalCount: Int! + """ + Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. + """ + viewerSubscription: SubscriptionState } -"""Represents a starred repository.""" -type StarredRepositoryEdge { - """A cursor for use in pagination.""" - cursor: String! - node: Repository! +"""Audit log entry for a team.add_member event.""" +type TeamAddMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & TeamAuditEntryData { + """The action name""" + action: String! - """Identifies when the item was starred.""" - starredAt: DateTime! -} + """The user who initiated the action""" + actor: AuditEntryActor -"""Represents a starred topic.""" -type StarredTopicEdge { - """A cursor for use in pagination.""" - cursor: String! - node: Topic! + """The IP address of the actor""" + actorIp: String - """Identifies when the item was starred.""" - starredAt: DateTime! -} + """A readable representation of the actor's location""" + actorLocation: ActorLocation -"""Represents a commit status.""" -type Status implements Node { - """The commit this status is attached to.""" - commit: Commit + """The username of the user who initiated the action""" + actorLogin: String - """Looks up an individual status context by context name.""" - context( - """The context name.""" - name: String! - ): StatusContext + """The HTTP path for the actor.""" + actorResourcePath: URI - """The individual status contexts for this commit.""" - contexts: [StatusContext!]! + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! id: ID! - """The combined commit status.""" - state: StatusState! -} + """Whether the team was mapped to an LDAP Group.""" + isLdapMapped: Boolean -"""Represents an individual commit status context""" -type StatusContext implements Node { - """ - The avatar of the OAuth application or the user that created the status - """ - avatarUrl( - """The size of the resulting square image.""" - size: Int = 40 - ): URI + """The corresponding operation type for the action""" + operationType: OperationType - """This commit this status context is attached to.""" - commit: Commit + """The Organization associated with the Audit Entry.""" + organization: Organization - """The name of this status context.""" - context: String! + """The name of the Organization.""" + organizationName: String - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """The HTTP path for the organization""" + organizationResourcePath: URI - """The actor who created this status context.""" - creator: Actor + """The HTTP URL for the organization""" + organizationUrl: URI - """The description for this status context.""" - description: String - id: ID! + """The team associated with the action""" + team: Team - """The state of this status context.""" - state: StatusState! + """The name of the team""" + teamName: String - """The URL for this status context.""" - targetUrl: URI -} + """The HTTP path for this team""" + teamResourcePath: URI -"""The possible commit status states.""" -enum StatusState { - """Status is expected.""" - EXPECTED + """The HTTP URL for this team""" + teamUrl: URI - """Status is errored.""" - ERROR + """The user affected by the action""" + user: User - """Status is failing.""" - FAILURE + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String - """Status is pending.""" - PENDING + """The HTTP path for the user.""" + userResourcePath: URI - """Status is successful.""" - SUCCESS + """The HTTP URL for the user.""" + userUrl: URI } -"""Autogenerated input type of SubmitPullRequestReview""" -input SubmitPullRequestReviewInput { - """The Pull Request Review ID to submit.""" - pullRequestReviewId: ID! +"""Audit log entry for a team.add_repository event.""" +type TeamAddRepositoryAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData & TeamAuditEntryData { + """The action name""" + action: String! - """The event to send to the Pull Request Review.""" - event: PullRequestReviewEvent! + """The user who initiated the action""" + actor: AuditEntryActor - """The text field to set on the Pull Request Review.""" - body: String + """The IP address of the actor""" + actorIp: String - """A unique identifier for the client performing the mutation.""" - clientMutationId: String -} + """A readable representation of the actor's location""" + actorLocation: ActorLocation -"""Autogenerated return type of SubmitPullRequestReview""" -type SubmitPullRequestReviewPayload { - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """The username of the user who initiated the action""" + actorLogin: String - """The submitted pull request review.""" - pullRequestReview: PullRequestReview -} + """The HTTP path for the actor.""" + actorResourcePath: URI -"""Entities that can be subscribed to for web and email notifications.""" -interface Subscribable { + """The HTTP URL for the actor.""" + actorUrl: URI + + """The time the action was initiated""" + createdAt: PreciseDateTime! id: ID! - """ - Check if the viewer is able to change their subscription status for the repository. - """ - viewerCanSubscribe: Boolean! + """Whether the team was mapped to an LDAP Group.""" + isLdapMapped: Boolean - """ - Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. - """ - viewerSubscription: SubscriptionState -} + """The corresponding operation type for the action""" + operationType: OperationType -"""Represents a 'subscribed' event on a given `Subscribable`.""" -type SubscribedEvent implements Node { - """Identifies the actor who performed the event.""" - actor: Actor + """The Organization associated with the Audit Entry.""" + organization: Organization - """Identifies the date and time when the object was created.""" - createdAt: DateTime! - id: ID! + """The name of the Organization.""" + organizationName: String - """Object referenced by event.""" - subscribable: Subscribable! -} + """The HTTP path for the organization""" + organizationResourcePath: URI -"""The possible states of a subscription.""" -enum SubscriptionState { - """The User is only notified when participating or @mentioned.""" - UNSUBSCRIBED + """The HTTP URL for the organization""" + organizationUrl: URI - """The User is notified of all conversations.""" - SUBSCRIBED + """The repository associated with the action""" + repository: Repository - """The User is never notified.""" - IGNORED -} + """The name of the repository""" + repositoryName: String -""" -A suggestion to review a pull request based on a user's commit history and review comments. -""" -type SuggestedReviewer { - """Is this suggestion based on past commits?""" - isAuthor: Boolean! + """The HTTP path for the repository""" + repositoryResourcePath: URI - """Is this suggestion based on past review comments?""" - isCommenter: Boolean! + """The HTTP URL for the repository""" + repositoryUrl: URI - """Identifies the user suggested to review the pull request.""" - reviewer: User! -} + """The team associated with the action""" + team: Team -"""Represents a Git tag.""" -type Tag implements Node & GitObject { - """An abbreviated version of the Git object ID""" - abbreviatedOid: String! + """The name of the team""" + teamName: String - """The HTTP path for this Git object""" - commitResourcePath: URI! + """The HTTP path for this team""" + teamResourcePath: URI - """The HTTP URL for this Git object""" - commitUrl: URI! - id: ID! + """The HTTP URL for this team""" + teamUrl: URI - """The Git tag message.""" - message: String + """The user affected by the action""" + user: User - """The Git tag name.""" - name: String! + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String - """The Git object ID""" - oid: GitObjectID! + """The HTTP path for the user.""" + userResourcePath: URI + + """The HTTP URL for the user.""" + userUrl: URI +} + +"""Metadata for an audit entry with action team.*""" +interface TeamAuditEntryData { + """The team associated with the action""" + team: Team - """The Repository the Git object belongs to""" - repository: Repository! + """The name of the team""" + teamName: String - """Details about the tag author.""" - tagger: GitActor + """The HTTP path for this team""" + teamResourcePath: URI - """The Git object the tag points to.""" - target: GitObject! + """The HTTP URL for this team""" + teamUrl: URI } -"""A team of users in an organization.""" -type Team implements Node & Subscribable & MemberStatusable { - """A list of teams that are ancestors of this team.""" - ancestors( - """Returns the elements in the list that come after the specified cursor.""" - after: String - - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String - - """Returns the first _n_ elements from the list.""" - first: Int +"""Audit log entry for a team.change_parent_team event.""" +type TeamChangeParentTeamAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & TeamAuditEntryData { + """The action name""" + action: String! - """Returns the last _n_ elements from the list.""" - last: Int - ): TeamConnection! + """The user who initiated the action""" + actor: AuditEntryActor - """A URL pointing to the team's avatar.""" - avatarUrl( - """The size in pixels of the resulting square image.""" - size: Int = 400 - ): URI + """The IP address of the actor""" + actorIp: String - """List of child teams belonging to this team""" - childTeams( - """Order for connection""" - orderBy: TeamOrder + """A readable representation of the actor's location""" + actorLocation: ActorLocation - """User logins to filter by""" - userLogins: [String!] + """The username of the user who initiated the action""" + actorLogin: String - """Whether to list immediate child teams or all descendant child teams.""" - immediateOnly: Boolean = true + """The HTTP path for the actor.""" + actorResourcePath: URI - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The HTTP URL for the actor.""" + actorUrl: URI - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The time the action was initiated""" + createdAt: PreciseDateTime! + id: ID! - """Returns the first _n_ elements from the list.""" - first: Int + """Whether the team was mapped to an LDAP Group.""" + isLdapMapped: Boolean - """Returns the last _n_ elements from the list.""" - last: Int - ): TeamConnection! + """The corresponding operation type for the action""" + operationType: OperationType - """The slug corresponding to the organization and team.""" - combinedSlug: String! + """The Organization associated with the Audit Entry.""" + organization: Organization - """Identifies the date and time when the object was created.""" - createdAt: DateTime! + """The name of the Organization.""" + organizationName: String - """The description of the team.""" - description: String + """The HTTP path for the organization""" + organizationResourcePath: URI - """The HTTP path for editing this team""" - editTeamResourcePath: URI! + """The HTTP URL for the organization""" + organizationUrl: URI - """The HTTP URL for editing this team""" - editTeamUrl: URI! - id: ID! + """The new parent team.""" + parentTeam: Team - """A list of pending invitations for users to this team""" - invitations( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The name of the new parent team""" + parentTeamName: String - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The name of the former parent team""" + parentTeamNameWas: String - """Returns the first _n_ elements from the list.""" - first: Int + """The HTTP path for the parent team""" + parentTeamResourcePath: URI - """Returns the last _n_ elements from the list.""" - last: Int - ): OrganizationInvitationConnection + """The HTTP URL for the parent team""" + parentTeamUrl: URI - """ - Get the status messages members of this entity have set that are either public or visible only to the organization. - """ - memberStatuses( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The former parent team.""" + parentTeamWas: Team - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The HTTP path for the previous parent team""" + parentTeamWasResourcePath: URI - """Returns the first _n_ elements from the list.""" - first: Int + """The HTTP URL for the previous parent team""" + parentTeamWasUrl: URI - """Returns the last _n_ elements from the list.""" - last: Int + """The team associated with the action""" + team: Team - """Ordering options for user statuses returned from the connection.""" - orderBy: UserStatusOrder - ): UserStatusConnection! + """The name of the team""" + teamName: String - """A list of users who are members of this team.""" - members( - """Returns the elements in the list that come after the specified cursor.""" - after: String + """The HTTP path for this team""" + teamResourcePath: URI - """ - Returns the elements in the list that come before the specified cursor. - """ - before: String + """The HTTP URL for this team""" + teamUrl: URI - """Returns the first _n_ elements from the list.""" - first: Int + """The user affected by the action""" + user: User - """Returns the last _n_ elements from the list.""" - last: Int + """ + For actions involving two users, the actor is the initiator and the user is the affected user. + """ + userLogin: String - """The search string to look for.""" - query: String + """The HTTP path for the user.""" + userResourcePath: URI - """Filter by membership type""" - membership: TeamMembershipType = ALL + """The HTTP URL for the user.""" + userUrl: URI +} - """Filter by team member role""" - role: TeamMemberRole +"""The connection type for Team.""" +type TeamConnection { + """A list of edges.""" + edges: [TeamEdge] - """Order for the connection.""" - orderBy: TeamMemberOrder - ): TeamMemberConnection! + """A list of nodes.""" + nodes: [Team] - """The HTTP path for the team' members""" - membersResourcePath: URI! + """Information to aid in pagination.""" + pageInfo: PageInfo! - """The HTTP URL for the team' members""" - membersUrl: URI! + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """The name of the team.""" - name: String! +"""A team discussion.""" +type TeamDiscussion implements Node & Comment & Deletable & Reactable & Subscribable & UniformResourceLocatable & Updatable & UpdatableComment { + """The actor who authored the comment.""" + author: Actor - """The HTTP path creating a new team""" - newTeamResourcePath: URI! + """Author's association with the discussion's team.""" + authorAssociation: CommentAuthorAssociation! - """The HTTP URL creating a new team""" - newTeamUrl: URI! + """The body as Markdown.""" + body: String! - """The organization that owns this team.""" - organization: Organization! + """The body rendered to HTML.""" + bodyHTML: HTML! - """The parent team of the team.""" - parentTeam: Team + """The body rendered to text.""" + bodyText: String! - """The level of privacy the team has.""" - privacy: TeamPrivacy! + """Identifies the discussion body hash.""" + bodyVersion: String! - """A list of repositories this team has access to.""" - repositories( + """A list of comments on this discussion.""" + comments( """Returns the elements in the list that come after the specified cursor.""" after: String @@ -17204,316 +20352,311 @@ type Team implements Node & Subscribable & MemberStatusable { """Returns the last _n_ elements from the list.""" last: Int - """The search string to look for.""" - query: String - - """Order for the connection.""" - orderBy: TeamRepositoryOrder - ): TeamRepositoryConnection! - - """The HTTP path for this team's repositories""" - repositoriesResourcePath: URI! - - """The HTTP URL for this team's repositories""" - repositoriesUrl: URI! + """Order for connection""" + orderBy: TeamDiscussionCommentOrder - """The HTTP path for this team""" - resourcePath: URI! + """ + When provided, filters the connection such that results begin with the comment with this number. + """ + fromComment: Int + ): TeamDiscussionCommentConnection! - """The slug corresponding to the team.""" - slug: String! + """The HTTP path for discussion comments""" + commentsResourcePath: URI! - """The HTTP path for this team's teams""" - teamsResourcePath: URI! + """The HTTP URL for discussion comments""" + commentsUrl: URI! - """The HTTP URL for this team's teams""" - teamsUrl: URI! + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """Identifies the date and time when the object was last updated.""" - updatedAt: DateTime! + """Check if this comment was created via an email reply.""" + createdViaEmail: Boolean! - """The HTTP URL for this team""" - url: URI! + """Identifies the primary key from the database.""" + databaseId: Int - """Team is adminable by the viewer.""" - viewerCanAdminister: Boolean! + """The actor who edited the comment.""" + editor: Actor + id: ID! """ - Check if the viewer is able to change their subscription status for the repository. + Check if this comment was edited and includes an edit with the creation data """ - viewerCanSubscribe: Boolean! + includesCreatedEdit: Boolean! + + """Whether or not the discussion is pinned.""" + isPinned: Boolean! """ - Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. + Whether or not the discussion is only visible to team members and org admins. """ - viewerSubscription: SubscriptionState -} - -"""Audit log entry for a team.add_member event.""" -type TeamAddMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & TeamAuditEntryData { - """The action name""" - action: String! - - """The user who initiated the action""" - actor: AuditEntryActor - - """The IP address of the actor""" - actorIp: String - - """A readable representation of the actor's location""" - actorLocation: ActorLocation - - """The username of the user who initiated the action""" - actorLogin: String + isPrivate: Boolean! - """The HTTP path for the actor.""" - actorResourcePath: URI + """The moment the editor made the last edit""" + lastEditedAt: DateTime - """The HTTP URL for the actor.""" - actorUrl: URI + """Identifies the discussion within its team.""" + number: Int! - """The time the action was initiated""" - createdAt: PreciseDateTime! - id: ID! + """Identifies when the comment was published at.""" + publishedAt: DateTime - """Whether the team was mapped to an LDAP Group.""" - isLdapMapped: Boolean + """A list of reactions grouped by content left on the subject.""" + reactionGroups: [ReactionGroup!] - """The Organization associated with the Audit Entry.""" - organization: Organization + """A list of Reactions left on the Issue.""" + reactions( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The name of the Organization.""" - organizationName: String + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The HTTP path for the organization""" - organizationResourcePath: URI + """Returns the first _n_ elements from the list.""" + first: Int - """The HTTP URL for the organization""" - organizationUrl: URI + """Returns the last _n_ elements from the list.""" + last: Int - """The team associated with the action""" - team: Team + """Allows filtering Reactions by emoji.""" + content: ReactionContent - """The name of the team""" - teamName: String + """Allows specifying the order in which reactions are returned.""" + orderBy: ReactionOrder + ): ReactionConnection! - """The HTTP path for this team""" - teamResourcePath: URI + """The HTTP path for this discussion""" + resourcePath: URI! - """The HTTP URL for this team""" - teamUrl: URI + """The team that defines the context of this discussion.""" + team: Team! - """The user affected by the action""" - user: User + """The title of the discussion""" + title: String! - """ - For actions involving two users, the actor is the initiator and the user is the affected user. - """ - userLogin: String + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! - """The HTTP path for the user.""" - userResourcePath: URI + """The HTTP URL for this discussion""" + url: URI! - """The HTTP URL for the user.""" - userUrl: URI -} + """A list of edits to this content.""" + userContentEdits( + """Returns the elements in the list that come after the specified cursor.""" + after: String -"""Audit log entry for a team.add_repository event.""" -type TeamAddRepositoryAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & RepositoryAuditEntryData & TeamAuditEntryData { - """The action name""" - action: String! + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The user who initiated the action""" - actor: AuditEntryActor + """Returns the first _n_ elements from the list.""" + first: Int - """The IP address of the actor""" - actorIp: String + """Returns the last _n_ elements from the list.""" + last: Int + ): UserContentEditConnection - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """Check if the current viewer can delete this object.""" + viewerCanDelete: Boolean! - """The username of the user who initiated the action""" - actorLogin: String + """Whether or not the current viewer can pin this discussion.""" + viewerCanPin: Boolean! - """The HTTP path for the actor.""" - actorResourcePath: URI + """Can user react to this subject""" + viewerCanReact: Boolean! - """The HTTP URL for the actor.""" - actorUrl: URI + """ + Check if the viewer is able to change their subscription status for the repository. + """ + viewerCanSubscribe: Boolean! - """The time the action was initiated""" - createdAt: PreciseDateTime! - id: ID! + """Check if the current viewer can update this object.""" + viewerCanUpdate: Boolean! - """Whether the team was mapped to an LDAP Group.""" - isLdapMapped: Boolean + """Reasons why the current viewer can not update this comment.""" + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! - """The Organization associated with the Audit Entry.""" - organization: Organization + """Did the viewer author this comment.""" + viewerDidAuthor: Boolean! - """The name of the Organization.""" - organizationName: String + """ + Identifies if the viewer is watching, not watching, or ignoring the subscribable entity. + """ + viewerSubscription: SubscriptionState +} - """The HTTP path for the organization""" - organizationResourcePath: URI +"""A comment on a team discussion.""" +type TeamDiscussionComment implements Node & Comment & Deletable & Reactable & UniformResourceLocatable & Updatable & UpdatableComment { + """The actor who authored the comment.""" + author: Actor - """The HTTP URL for the organization""" - organizationUrl: URI + """Author's association with the comment's team.""" + authorAssociation: CommentAuthorAssociation! - """The repository associated with the action""" - repository: Repository + """The body as Markdown.""" + body: String! - """The name of the repository""" - repositoryName: String + """The body rendered to HTML.""" + bodyHTML: HTML! - """The HTTP path for the repository""" - repositoryResourcePath: URI + """The body rendered to text.""" + bodyText: String! - """The HTTP URL for the repository""" - repositoryUrl: URI + """The current version of the body content.""" + bodyVersion: String! - """The team associated with the action""" - team: Team + """Identifies the date and time when the object was created.""" + createdAt: DateTime! - """The name of the team""" - teamName: String + """Check if this comment was created via an email reply.""" + createdViaEmail: Boolean! - """The HTTP path for this team""" - teamResourcePath: URI + """Identifies the primary key from the database.""" + databaseId: Int - """The HTTP URL for this team""" - teamUrl: URI + """The discussion this comment is about.""" + discussion: TeamDiscussion! - """The user affected by the action""" - user: User + """The actor who edited the comment.""" + editor: Actor + id: ID! """ - For actions involving two users, the actor is the initiator and the user is the affected user. + Check if this comment was edited and includes an edit with the creation data """ - userLogin: String - - """The HTTP path for the user.""" - userResourcePath: URI - - """The HTTP URL for the user.""" - userUrl: URI -} + includesCreatedEdit: Boolean! -"""Metadata for an audit entry with action team.*""" -interface TeamAuditEntryData { - """The team associated with the action""" - team: Team + """The moment the editor made the last edit""" + lastEditedAt: DateTime - """The name of the team""" - teamName: String + """Identifies the comment number.""" + number: Int! - """The HTTP path for this team""" - teamResourcePath: URI + """Identifies when the comment was published at.""" + publishedAt: DateTime - """The HTTP URL for this team""" - teamUrl: URI -} + """A list of reactions grouped by content left on the subject.""" + reactionGroups: [ReactionGroup!] -"""Audit log entry for a team.change_parent_team event.""" -type TeamChangeParentTeamAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & TeamAuditEntryData { - """The action name""" - action: String! + """A list of Reactions left on the Issue.""" + reactions( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The user who initiated the action""" - actor: AuditEntryActor + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The IP address of the actor""" - actorIp: String + """Returns the first _n_ elements from the list.""" + first: Int - """A readable representation of the actor's location""" - actorLocation: ActorLocation + """Returns the last _n_ elements from the list.""" + last: Int - """The username of the user who initiated the action""" - actorLogin: String + """Allows filtering Reactions by emoji.""" + content: ReactionContent - """The HTTP path for the actor.""" - actorResourcePath: URI + """Allows specifying the order in which reactions are returned.""" + orderBy: ReactionOrder + ): ReactionConnection! - """The HTTP URL for the actor.""" - actorUrl: URI + """The HTTP path for this comment""" + resourcePath: URI! - """The time the action was initiated""" - createdAt: PreciseDateTime! - id: ID! + """Identifies the date and time when the object was last updated.""" + updatedAt: DateTime! - """Whether the team was mapped to an LDAP Group.""" - isLdapMapped: Boolean + """The HTTP URL for this comment""" + url: URI! - """The Organization associated with the Audit Entry.""" - organization: Organization + """A list of edits to this content.""" + userContentEdits( + """Returns the elements in the list that come after the specified cursor.""" + after: String - """The name of the Organization.""" - organizationName: String + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String - """The HTTP path for the organization""" - organizationResourcePath: URI + """Returns the first _n_ elements from the list.""" + first: Int - """The HTTP URL for the organization""" - organizationUrl: URI + """Returns the last _n_ elements from the list.""" + last: Int + ): UserContentEditConnection - """The new parent team.""" - parentTeam: Team + """Check if the current viewer can delete this object.""" + viewerCanDelete: Boolean! - """The name of the new parent team""" - parentTeamName: String + """Can user react to this subject""" + viewerCanReact: Boolean! - """The name of the former parent team""" - parentTeamNameWas: String + """Check if the current viewer can update this object.""" + viewerCanUpdate: Boolean! - """The HTTP path for the parent team""" - parentTeamResourcePath: URI + """Reasons why the current viewer can not update this comment.""" + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! - """The HTTP URL for the parent team""" - parentTeamUrl: URI + """Did the viewer author this comment.""" + viewerDidAuthor: Boolean! +} - """The former parent team.""" - parentTeamWas: Team +"""The connection type for TeamDiscussionComment.""" +type TeamDiscussionCommentConnection { + """A list of edges.""" + edges: [TeamDiscussionCommentEdge] - """The HTTP path for the previous parent team""" - parentTeamWasResourcePath: URI + """A list of nodes.""" + nodes: [TeamDiscussionComment] - """The HTTP URL for the previous parent team""" - parentTeamWasUrl: URI + """Information to aid in pagination.""" + pageInfo: PageInfo! - """The team associated with the action""" - team: Team + """Identifies the total count of items in the connection.""" + totalCount: Int! +} - """The name of the team""" - teamName: String +"""An edge in a connection.""" +type TeamDiscussionCommentEdge { + """A cursor for use in pagination.""" + cursor: String! - """The HTTP path for this team""" - teamResourcePath: URI + """The item at the end of the edge.""" + node: TeamDiscussionComment +} - """The HTTP URL for this team""" - teamUrl: URI +"""Ways in which team discussion comment connections can be ordered.""" +input TeamDiscussionCommentOrder { + """The field by which to order nodes.""" + field: TeamDiscussionCommentOrderField! - """The user affected by the action""" - user: User + """The direction in which to order nodes.""" + direction: OrderDirection! +} +""" +Properties by which team discussion comment connections can be ordered. +""" +enum TeamDiscussionCommentOrderField { """ - For actions involving two users, the actor is the initiator and the user is the affected user. + Allows sequential ordering of team discussion comments (which is equivalent to chronological ordering). """ - userLogin: String - - """The HTTP path for the user.""" - userResourcePath: URI - - """The HTTP URL for the user.""" - userUrl: URI + NUMBER } -"""The connection type for Team.""" -type TeamConnection { +"""The connection type for TeamDiscussion.""" +type TeamDiscussionConnection { """A list of edges.""" - edges: [TeamEdge] + edges: [TeamDiscussionEdge] """A list of nodes.""" - nodes: [Team] + nodes: [TeamDiscussion] """Information to aid in pagination.""" pageInfo: PageInfo! @@ -17523,16 +20666,31 @@ type TeamConnection { } """An edge in a connection.""" -type TeamEdge { +type TeamDiscussionEdge { """A cursor for use in pagination.""" cursor: String! """The item at the end of the edge.""" - node: Team + node: TeamDiscussion +} + +"""Ways in which team discussion connections can be ordered.""" +input TeamDiscussionOrder { + """The field by which to order nodes.""" + field: TeamDiscussionOrderField! + + """The direction in which to order nodes.""" + direction: OrderDirection! +} + +"""Properties by which team discussion connections can be ordered.""" +enum TeamDiscussionOrderField { + """Allows chronological ordering of team discussions.""" + CREATED_AT } -"""Represents a team's eligibility to be a child team of another""" -type TeamEligibilityEdge { +"""An edge in a connection.""" +type TeamEdge { """A cursor for use in pagination.""" cursor: String! @@ -17638,24 +20796,6 @@ enum TeamPrivacy { VISIBLE } -"""Represents a connection between a team (parent) and a project (child).""" -type TeamProjectEdge { - """A cursor for use in pagination.""" - cursor: String! - - """The parent team that grants inherited permission to this project""" - inheritedPermissionOrigin: Team - - """The item at the end of the edge.""" - node: Project - - """The HTTP path for this team's project""" - teamProjectResourcePath: URI! - - """The HTTP URL for this team's project""" - teamProjectUrl: URI! -} - """Audit log entry for a team.remove_member event.""" type TeamRemoveMemberAuditEntry implements Node & AuditEntry & OrganizationAuditEntryData & TeamAuditEntryData { """The action name""" @@ -17686,6 +20826,9 @@ type TeamRemoveMemberAuditEntry implements Node & AuditEntry & OrganizationAudit """Whether the team was mapped to an LDAP Group.""" isLdapMapped: Boolean + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -17755,6 +20898,9 @@ type TeamRemoveRepositoryAuditEntry implements Node & AuditEntry & OrganizationA """Whether the team was mapped to an LDAP Group.""" isLdapMapped: Boolean + """The corresponding operation type for the action""" + operationType: OperationType + """The Organization associated with the Audit Entry.""" organization: Organization @@ -17989,10 +21135,10 @@ enum TopicSuggestionDeclineReason { """Autogenerated input type of TransferIssue""" input TransferIssueInput { - """The ID of the issue to be transferred""" + """The Node ID of the issue to be transferred""" issueId: ID! - """The ID of the repository the issue should be transferred to""" + """The Node ID of the repository the issue should be transferred to""" repositoryId: ID! """A unique identifier for the client performing the mutation.""" @@ -18083,6 +21229,24 @@ type UnassignedEvent implements Node { id: ID! } +"""Autogenerated input type of UnfollowUser""" +input UnfollowUserInput { + """ID of the user to unfollow.""" + userId: ID! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of UnfollowUser""" +type UnfollowUserPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The user that was unfollowed.""" + user: User +} + """Represents a type that can be retrieved by a URL.""" interface UniformResourceLocatable { """The HTML path to this resource.""" @@ -18334,7 +21498,7 @@ input UpdateBranchProtectionRuleInput { """Is pushing to matching branches restricted.""" restrictsPushes: Boolean - """A list of User or Team IDs allowed to push to matching branches.""" + """A list of User, Team or App IDs allowed to push to matching branches.""" pushActorIds: [ID!] """ @@ -18437,8 +21601,29 @@ input UpdateEnterpriseActionExecutionCapabilitySettingInput { """ enterpriseId: ID! + """ + The value for the action execution capability setting on the enterprise. + """ + capability: ActionExecutionCapabilitySetting! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseActionExecutionCapabilitySetting +""" +type UpdateEnterpriseActionExecutionCapabilitySettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The enterprise with the updated action execution capability setting.""" + enterprise: Enterprise + + """ + A message confirming the result of updating the action execution capability setting. + """ + message: String } """Autogenerated input type of UpdateEnterpriseAdministratorRole""" @@ -18446,102 +21631,290 @@ input UpdateEnterpriseAdministratorRoleInput { """The ID of the Enterprise which the admin belongs to.""" enterpriseId: ID! - """The login of a administrator whose role is being changed.""" - login: String! + """The login of a administrator whose role is being changed.""" + login: String! + + """The new role for the Enterprise administrator.""" + role: EnterpriseAdministratorRole! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of UpdateEnterpriseAdministratorRole""" +type UpdateEnterpriseAdministratorRolePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """A message confirming the result of changing the administrator's role.""" + message: String +} + +""" +Autogenerated input type of UpdateEnterpriseAllowPrivateRepositoryForkingSetting +""" +input UpdateEnterpriseAllowPrivateRepositoryForkingSettingInput { + """ + The ID of the enterprise on which to set the allow private repository forking setting. + """ + enterpriseId: ID! + + """ + The value for the allow private repository forking setting on the enterprise. + """ + settingValue: EnterpriseEnabledDisabledSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseAllowPrivateRepositoryForkingSetting +""" +type UpdateEnterpriseAllowPrivateRepositoryForkingSettingPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """ + The enterprise with the updated allow private repository forking setting. + """ + enterprise: Enterprise + + """ + A message confirming the result of updating the allow private repository forking setting. + """ + message: String +} + +""" +Autogenerated input type of UpdateEnterpriseDefaultRepositoryPermissionSetting +""" +input UpdateEnterpriseDefaultRepositoryPermissionSettingInput { + """ + The ID of the enterprise on which to set the default repository permission setting. + """ + enterpriseId: ID! + + """ + The value for the default repository permission setting on the enterprise. + """ + settingValue: EnterpriseDefaultRepositoryPermissionSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseDefaultRepositoryPermissionSetting +""" +type UpdateEnterpriseDefaultRepositoryPermissionSettingPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The enterprise with the updated default repository permission setting.""" + enterprise: Enterprise + + """ + A message confirming the result of updating the default repository permission setting. + """ + message: String +} + +""" +Autogenerated input type of UpdateEnterpriseMembersCanChangeRepositoryVisibilitySetting +""" +input UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingInput { + """ + The ID of the enterprise on which to set the members can change repository visibility setting. + """ + enterpriseId: ID! + + """ + The value for the members can change repository visibility setting on the enterprise. + """ + settingValue: EnterpriseEnabledDisabledSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseMembersCanChangeRepositoryVisibilitySetting +""" +type UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """ + The enterprise with the updated members can change repository visibility setting. + """ + enterprise: Enterprise + + """ + A message confirming the result of updating the members can change repository visibility setting. + """ + message: String +} + +""" +Autogenerated input type of UpdateEnterpriseMembersCanCreateRepositoriesSetting +""" +input UpdateEnterpriseMembersCanCreateRepositoriesSettingInput { + """ + The ID of the enterprise on which to set the members can create repositories setting. + """ + enterpriseId: ID! + + """ + Value for the members can create repositories setting on the enterprise. This + or the granular public/private/internal allowed fields (but not both) must be provided. + """ + settingValue: EnterpriseMembersCanCreateRepositoriesSettingValue + + """ + When false, allow member organizations to set their own repository creation member privileges. + """ + membersCanCreateRepositoriesPolicyEnabled: Boolean + + """ + Allow members to create public repositories. Defaults to current value. + """ + membersCanCreatePublicRepositories: Boolean + + """ + Allow members to create private repositories. Defaults to current value. + """ + membersCanCreatePrivateRepositories: Boolean + + """ + Allow members to create internal repositories. Defaults to current value. + """ + membersCanCreateInternalRepositories: Boolean """A unique identifier for the client performing the mutation.""" clientMutationId: String } """ -Autogenerated input type of UpdateEnterpriseAllowPrivateRepositoryForkingSetting +Autogenerated return type of UpdateEnterpriseMembersCanCreateRepositoriesSetting """ -input UpdateEnterpriseAllowPrivateRepositoryForkingSettingInput { +type UpdateEnterpriseMembersCanCreateRepositoriesSettingPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + """ - The ID of the enterprise on which to set the allow private repository forking setting. + The enterprise with the updated members can create repositories setting. """ - enterpriseId: ID! + enterprise: Enterprise - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """ + A message confirming the result of updating the members can create repositories setting. + """ + message: String } """ -Autogenerated input type of UpdateEnterpriseDefaultRepositoryPermissionSetting +Autogenerated input type of UpdateEnterpriseMembersCanDeleteIssuesSetting """ -input UpdateEnterpriseDefaultRepositoryPermissionSettingInput { +input UpdateEnterpriseMembersCanDeleteIssuesSettingInput { """ - The ID of the enterprise on which to set the default repository permission setting. + The ID of the enterprise on which to set the members can delete issues setting. """ enterpriseId: ID! + """The value for the members can delete issues setting on the enterprise.""" + settingValue: EnterpriseEnabledDisabledSettingValue! + """A unique identifier for the client performing the mutation.""" clientMutationId: String } """ -Autogenerated input type of UpdateEnterpriseMembersCanChangeRepositoryVisibilitySetting +Autogenerated return type of UpdateEnterpriseMembersCanDeleteIssuesSetting """ -input UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingInput { - """ - The ID of the enterprise on which to set the members can change repository visibility setting. - """ - enterpriseId: ID! - +type UpdateEnterpriseMembersCanDeleteIssuesSettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The enterprise with the updated members can delete issues setting.""" + enterprise: Enterprise + + """ + A message confirming the result of updating the members can delete issues setting. + """ + message: String } """ -Autogenerated input type of UpdateEnterpriseMembersCanCreateRepositoriesSetting +Autogenerated input type of UpdateEnterpriseMembersCanDeleteRepositoriesSetting """ -input UpdateEnterpriseMembersCanCreateRepositoriesSettingInput { +input UpdateEnterpriseMembersCanDeleteRepositoriesSettingInput { """ - The ID of the enterprise on which to set the members can create repositories setting. + The ID of the enterprise on which to set the members can delete repositories setting. """ enterpriseId: ID! + """ + The value for the members can delete repositories setting on the enterprise. + """ + settingValue: EnterpriseEnabledDisabledSettingValue! + """A unique identifier for the client performing the mutation.""" clientMutationId: String } """ -Autogenerated input type of UpdateEnterpriseMembersCanDeleteIssuesSetting +Autogenerated return type of UpdateEnterpriseMembersCanDeleteRepositoriesSetting """ -input UpdateEnterpriseMembersCanDeleteIssuesSettingInput { +type UpdateEnterpriseMembersCanDeleteRepositoriesSettingPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + """ - The ID of the enterprise on which to set the members can delete issues setting. + The enterprise with the updated members can delete repositories setting. """ - enterpriseId: ID! + enterprise: Enterprise - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """ + A message confirming the result of updating the members can delete repositories setting. + """ + message: String } """ -Autogenerated input type of UpdateEnterpriseMembersCanDeleteRepositoriesSetting +Autogenerated input type of UpdateEnterpriseMembersCanInviteCollaboratorsSetting """ -input UpdateEnterpriseMembersCanDeleteRepositoriesSettingInput { +input UpdateEnterpriseMembersCanInviteCollaboratorsSettingInput { """ - The ID of the enterprise on which to set the members can delete repositories setting. + The ID of the enterprise on which to set the members can invite collaborators setting. """ enterpriseId: ID! + """ + The value for the members can invite collaborators setting on the enterprise. + """ + settingValue: EnterpriseEnabledDisabledSettingValue! + """A unique identifier for the client performing the mutation.""" clientMutationId: String } """ -Autogenerated input type of UpdateEnterpriseMembersCanInviteCollaboratorsSetting +Autogenerated return type of UpdateEnterpriseMembersCanInviteCollaboratorsSetting """ -input UpdateEnterpriseMembersCanInviteCollaboratorsSettingInput { +type UpdateEnterpriseMembersCanInviteCollaboratorsSettingPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + """ - The ID of the enterprise on which to set the members can invite collaborators setting. + The enterprise with the updated members can invite collaborators setting. """ - enterpriseId: ID! + enterprise: Enterprise - """A unique identifier for the client performing the mutation.""" - clientMutationId: String + """ + A message confirming the result of updating the members can invite collaborators setting. + """ + message: String } """ @@ -18553,8 +21926,29 @@ input UpdateEnterpriseMembersCanMakePurchasesSettingInput { """ enterpriseId: ID! + """ + The value for the members can make purchases setting on the enterprise. + """ + settingValue: EnterpriseMembersCanMakePurchasesSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseMembersCanMakePurchasesSetting +""" +type UpdateEnterpriseMembersCanMakePurchasesSettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The enterprise with the updated members can make purchases setting.""" + enterprise: Enterprise + + """ + A message confirming the result of updating the members can make purchases setting. + """ + message: String } """ @@ -18566,8 +21960,31 @@ input UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingInput { """ enterpriseId: ID! + """ + The value for the members can update protected branches setting on the enterprise. + """ + settingValue: EnterpriseEnabledDisabledSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseMembersCanUpdateProtectedBranchesSetting +""" +type UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """ + The enterprise with the updated members can update protected branches setting. + """ + enterprise: Enterprise + + """ + A message confirming the result of updating the members can update protected branches setting. + """ + message: String } """ @@ -18579,8 +21996,31 @@ input UpdateEnterpriseMembersCanViewDependencyInsightsSettingInput { """ enterpriseId: ID! + """ + The value for the members can view dependency insights setting on the enterprise. + """ + settingValue: EnterpriseEnabledDisabledSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseMembersCanViewDependencyInsightsSetting +""" +type UpdateEnterpriseMembersCanViewDependencyInsightsSettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """ + The enterprise with the updated members can view dependency insights setting. + """ + enterprise: Enterprise + + """ + A message confirming the result of updating the members can view dependency insights setting. + """ + message: String } """ @@ -18592,8 +22032,27 @@ input UpdateEnterpriseOrganizationProjectsSettingInput { """ enterpriseId: ID! + """The value for the organization projects setting on the enterprise.""" + settingValue: EnterpriseEnabledDisabledSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +""" +Autogenerated return type of UpdateEnterpriseOrganizationProjectsSetting +""" +type UpdateEnterpriseOrganizationProjectsSettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The enterprise with the updated organization projects setting.""" + enterprise: Enterprise + + """ + A message confirming the result of updating the organization projects setting. + """ + message: String } """Autogenerated input type of UpdateEnterpriseProfile""" @@ -18617,6 +22076,15 @@ input UpdateEnterpriseProfileInput { clientMutationId: String } +"""Autogenerated return type of UpdateEnterpriseProfile""" +type UpdateEnterpriseProfilePayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The updated enterprise.""" + enterprise: Enterprise +} + """Autogenerated input type of UpdateEnterpriseRepositoryProjectsSetting""" input UpdateEnterpriseRepositoryProjectsSettingInput { """ @@ -18624,8 +22092,25 @@ input UpdateEnterpriseRepositoryProjectsSettingInput { """ enterpriseId: ID! + """The value for the repository projects setting on the enterprise.""" + settingValue: EnterpriseEnabledDisabledSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of UpdateEnterpriseRepositoryProjectsSetting""" +type UpdateEnterpriseRepositoryProjectsSettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The enterprise with the updated repository projects setting.""" + enterprise: Enterprise + + """ + A message confirming the result of updating the repository projects setting. + """ + message: String } """Autogenerated input type of UpdateEnterpriseTeamDiscussionsSetting""" @@ -18633,8 +22118,25 @@ input UpdateEnterpriseTeamDiscussionsSettingInput { """The ID of the enterprise on which to set the team discussions setting.""" enterpriseId: ID! + """The value for the team discussions setting on the enterprise.""" + settingValue: EnterpriseEnabledDisabledSettingValue! + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of UpdateEnterpriseTeamDiscussionsSetting""" +type UpdateEnterpriseTeamDiscussionsSettingPayload { """A unique identifier for the client performing the mutation.""" clientMutationId: String + + """The enterprise with the updated team discussions setting.""" + enterprise: Enterprise + + """ + A message confirming the result of updating the team discussions setting. + """ + message: String } """ @@ -18646,10 +22148,33 @@ input UpdateEnterpriseTwoFactorAuthenticationRequiredSettingInput { """ enterpriseId: ID! + """ + The value for the two factor authentication required setting on the enterprise. + """ + settingValue: EnterpriseEnabledSettingValue! + """A unique identifier for the client performing the mutation.""" clientMutationId: String } +""" +Autogenerated return type of UpdateEnterpriseTwoFactorAuthenticationRequiredSetting +""" +type UpdateEnterpriseTwoFactorAuthenticationRequiredSettingPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """ + The enterprise with the updated two factor authentication required setting. + """ + enterprise: Enterprise + + """ + A message confirming the result of updating the two factor authentication required setting. + """ + message: String +} + """Autogenerated input type of UpdateIssueComment""" input UpdateIssueCommentInput { """The ID of the IssueComment to modify.""" @@ -18803,9 +22328,24 @@ input UpdatePullRequestInput { """The contents of the pull request.""" body: String + """The target state of the pull request.""" + state: PullRequestUpdateState + """Indicates whether maintainers can modify the pull request.""" maintainerCanModify: Boolean + """An array of Node IDs of users for this pull request.""" + assigneeIds: [ID!] + + """The Node ID of the milestone for this pull request.""" + milestoneId: ID + + """An array of Node IDs of labels for this pull request.""" + labelIds: [ID!] + + """An array of Node IDs for projects associated with this pull request.""" + projectIds: [ID!] + """A unique identifier for the client performing the mutation.""" clientMutationId: String } @@ -18954,6 +22494,63 @@ type UpdateSubscriptionPayload { subscribable: Subscribable } +"""Autogenerated input type of UpdateTeamDiscussionComment""" +input UpdateTeamDiscussionCommentInput { + """The ID of the comment to modify.""" + id: ID! + + """The updated text of the comment.""" + body: String! + + """The current version of the body content.""" + bodyVersion: String + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of UpdateTeamDiscussionComment""" +type UpdateTeamDiscussionCommentPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The updated comment.""" + teamDiscussionComment: TeamDiscussionComment +} + +"""Autogenerated input type of UpdateTeamDiscussion""" +input UpdateTeamDiscussionInput { + """The Node ID of the discussion to modify.""" + id: ID! + + """The updated title of the discussion.""" + title: String + + """The updated text of the discussion.""" + body: 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. + """ + bodyVersion: String + + """If provided, sets the pinned state of the updated discussion.""" + pinned: Boolean + + """A unique identifier for the client performing the mutation.""" + clientMutationId: String +} + +"""Autogenerated return type of UpdateTeamDiscussion""" +type UpdateTeamDiscussionPayload { + """A unique identifier for the client performing the mutation.""" + clientMutationId: String + + """The updated discussion.""" + teamDiscussion: TeamDiscussion +} + """Autogenerated input type of UpdateTopics""" input UpdateTopicsInput { """The Node ID of the repository.""" @@ -19135,6 +22732,12 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """Returns the last _n_ elements from the list.""" last: Int ): GistConnection! + + """The hovercard information for this user in a given context""" + hovercard( + """The ID of the subject to get the hovercard in the context of""" + primarySubjectId: ID + ): Hovercard! id: ID! """ @@ -19550,7 +23153,7 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch last: Int """The field to order saved replies by.""" - orderBy: SavedReplyOrder + orderBy: SavedReplyOrder = {field: UPDATED_AT, direction: DESC} ): SavedReplyConnection """This object's sponsorships as the maintainer.""" @@ -19630,6 +23233,32 @@ type User implements Node & Actor & RegistryPackageOwner & RegistryPackageSearch """The user's description of what they're currently doing.""" status: UserStatus + """ + Repositories the user has contributed to, ordered by contribution rank, plus repositories the user has created + + """ + topRepositories( + """Returns the elements in the list that come after the specified cursor.""" + after: String + + """ + Returns the elements in the list that come before the specified cursor. + """ + before: String + + """Returns the first _n_ elements from the list.""" + first: Int + + """Returns the last _n_ elements from the list.""" + last: Int + + """Ordering options for repositories returned from the connection""" + orderBy: RepositoryOrder! + + """How far back in time to fetch contributed repositories""" + since: DateTime + ): RepositoryConnection! + """Identifies the date and time when the object was last updated.""" updatedAt: DateTime! @@ -19873,5 +23502,19 @@ enum UserStatusOrderField { UPDATED_AT } +""" +A hovercard context with a message describing how the viewer is related. +""" +type ViewerHovercardContext implements HovercardContext { + """A string describing this context""" + message: String! + + """An octicon to accompany this context""" + octicon: String! + + """Identifies the user who is related to this context.""" + viewer: User! +} + """A valid x509 certificate string""" scalar X509Certificate