Skip to content
This repository was archived by the owner on Apr 1, 2024. It is now read-only.

Latest commit

 

History

History
7750 lines (6227 loc) · 207 KB

input_objects.md

File metadata and controls

7750 lines (6227 loc) · 207 KB

Input objects

About input objects

Input objects can be described as "composable objects" because they include a set of input fields that define the object.

AbortQueuedMigrationsInput

Autogenerated input type of AbortQueuedMigrations

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

ownerId (ID!)

The ID of the organization that is running the migrations.


AcceptEnterpriseAdministratorInvitationInput

Autogenerated input type of AcceptEnterpriseAdministratorInvitation

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

invitationId (ID!)

The id of the invitation being accepted


AcceptTopicSuggestionInput

Autogenerated input type of AcceptTopicSuggestion

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of the suggested topic.

repositoryId (ID!)

The Node ID of the repository.


AddAssigneesToAssignableInput

Autogenerated input type of AddAssigneesToAssignable

Input fields

Name Description
assignableId (ID!)

The id of the assignable object to add assignees to.

assigneeIds ([ID!]!)

The id of users to add as assignees.

clientMutationId (String)

A unique identifier for the client performing the mutation.


AddCommentInput

Autogenerated input type of AddComment

Input fields

Name Description
body (String!)

The contents of the comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

subjectId (ID!)

The Node ID of the subject to modify.


AddDiscussionCommentInput

Autogenerated input type of AddDiscussionComment

Input fields

Name Description
body (String!)

The contents of the comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussionId (ID!)

The Node ID of the discussion to comment on.

replyToId (ID)

The Node ID of the discussion comment within this discussion to reply to.


AddEnterpriseSupportEntitlementInput

Autogenerated input type of AddEnterpriseSupportEntitlement

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the Enterprise which the admin belongs to.

login (String!)

The login of a member who will receive the support entitlement.


AddLabelsToLabelableInput

Autogenerated input type of AddLabelsToLabelable

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

labelIds ([ID!]!)

The ids of the labels to add.

labelableId (ID!)

The id of the labelable object to add labels to.


AddProjectCardInput

Autogenerated input type of AddProjectCard

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

contentId (ID)

The content of the card. Must be a member of the ProjectCardItem union

note (String)

The note on the card.

projectColumnId (ID!)

The Node ID of the ProjectColumn.


AddProjectColumnInput

Autogenerated input type of AddProjectColumn

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of the column.

projectId (ID!)

The Node ID of the project.


AddProjectNextItemInput

Autogenerated input type of AddProjectNextItem

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

contentId (ID!)

The content id of the item (Issue or PullRequest).

projectId (ID!)

The ID of the Project to add the item to.


AddPullRequestReviewCommentInput

Autogenerated input type of AddPullRequestReviewComment

Input fields

Name Description
body (String!)

The text of the comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

commitOID (GitObjectID)

The SHA of the commit to comment on.

inReplyTo (ID)

The comment id to reply to.

path (String)

The relative path of the file to comment on.

position (Int)

The line index in the diff to comment on.

pullRequestId (ID)

The node ID of the pull request reviewing

pullRequestReviewId (ID)

The Node ID of the review to modify.


AddPullRequestReviewInput

Autogenerated input type of AddPullRequestReview

Input fields

Name Description
body (String)

The contents of the review body comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

comments ([DraftPullRequestReviewComment])

The review line comments.

commitOID (GitObjectID)

The commit OID the review pertains to.

event (PullRequestReviewEvent)

The event to perform on the pull request review.

pullRequestId (ID!)

The Node ID of the pull request to modify.

threads ([DraftPullRequestReviewThread])

The review line comment threads.


AddPullRequestReviewThreadInput

Autogenerated input type of AddPullRequestReviewThread

Input fields

Name Description
body (String!)

Body of the thread’s first comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

line (Int!)

The line of the blob to which the thread refers. The end of the line range for multi-line comments.

path (String!)

Path to the file being commented on.

pullRequestId (ID)

The node ID of the pull request reviewing

pullRequestReviewId (ID)

The Node ID of the review to modify.

side (DiffSide)

The side of the diff on which the line resides. For multi-line comments, this is the side for the end of the line range.

startLine (Int)

The first line of the range to which the comment refers.

startSide (DiffSide)

The side of the diff on which the start line resides.


AddReactionInput

Autogenerated input type of AddReaction

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

content (ReactionContent!)

The name of the emoji to react with.

subjectId (ID!)

The Node ID of the subject to modify.


AddStarInput

Autogenerated input type of AddStar

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

starrableId (ID!)

The Starrable ID to star.


AddUpvoteInput

Autogenerated input type of AddUpvote

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

subjectId (ID!)

The Node ID of the discussion or comment to upvote.


AddVerifiableDomainInput

Autogenerated input type of AddVerifiableDomain

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

domain (URI!)

The URL of the domain

ownerId (ID!)

The ID of the owner to add the domain to


ApproveDeploymentsInput

Autogenerated input type of ApproveDeployments

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

comment (String)

Optional comment for approving deployments

environmentIds ([ID!]!)

The ids of environments to reject deployments

workflowRunId (ID!)

The node ID of the workflow run containing the pending deployments.


ApproveVerifiableDomainInput

Autogenerated input type of ApproveVerifiableDomain

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the verifiable domain to approve.


ArchiveRepositoryInput

Autogenerated input type of ArchiveRepository

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

repositoryId (ID!)

The ID of the repository to mark as archived.


AuditLogOrder

Ordering options for Audit Log connections.

Input fields

Name Description
direction (OrderDirection)

The ordering direction.

field (AuditLogOrderField)

The field to order Audit Logs by.


CancelEnterpriseAdminInvitationInput

Autogenerated input type of CancelEnterpriseAdminInvitation

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

invitationId (ID!)

The Node ID of the pending enterprise administrator invitation.


CancelSponsorshipInput

Autogenerated input type of CancelSponsorship

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorId (ID)

The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given.

sponsorLogin (String)

The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given.

sponsorableId (ID)

The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given.

sponsorableLogin (String)

The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given.


ChangeUserStatusInput

Autogenerated input type of ChangeUserStatus

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

emoji (String)

The emoji to represent your status. Can either be a native Unicode emoji or an emoji name with colons, e.g., 😀.

expiresAt (DateTime)

If set, the user status will not be shown after this date.

limitedAvailability (Boolean)

Whether this status should indicate you are not fully available on GitHub, e.g., you are away.

message (String)

A short description of your current status.

organizationId (ID)

The ID of the organization whose members will be allowed to see the status. If omitted, the status will be publicly visible.


CheckAnnotationData

Information from a check run analysis to specific lines of code.

Input fields

Name Description
annotationLevel (CheckAnnotationLevel!)

Represents an annotation’s information level

location (CheckAnnotationRange!)

The location of the annotation

message (String!)

A short description of the feedback for these lines of code.

path (String!)

The path of the file to add an annotation to.

rawDetails (String)

Details about this annotation.

title (String)

The title that represents the annotation.


CheckAnnotationRange

Information from a check run analysis to specific lines of code.

Input fields

Name Description
endColumn (Int)

The ending column of the range.

endLine (Int!)

The ending line of the range.

startColumn (Int)

The starting column of the range.

startLine (Int!)

The starting line of the range.


CheckRunAction

Possible further actions the integrator can perform.

Input fields

Name Description
description (String!)

A short explanation of what this action would do.

identifier (String!)

A reference for the action on the integrator’s system.

label (String!)

The text to be displayed on a button in the web UI.


CheckRunFilter

The filters that are available when fetching check runs.

Input fields

Name Description
appId (Int)

Filters the check runs created by this application ID.

checkName (String)

Filters the check runs by this name.

checkType (CheckRunType)

Filters the check runs by this type.

status (CheckStatusState)

Filters the check runs by this status.


CheckRunOutput

Descriptive details about the check run.

Input fields

Name Description
annotations ([CheckAnnotationData!])

The annotations that are made as part of the check run.

images ([CheckRunOutputImage!])

Images attached to the check run output displayed in the GitHub pull request UI.

summary (String!)

The summary of the check run (supports Commonmark).

text (String)

The details of the check run (supports Commonmark).

title (String!)

A title to provide for this check run.


CheckRunOutputImage

Images attached to the check run output displayed in the GitHub pull request UI.

Input fields

Name Description
alt (String!)

The alternative text for the image.

caption (String)

A short image description.

imageUrl (URI!)

The full URL of the image.


CheckSuiteAutoTriggerPreference

The auto-trigger preferences that are available for check suites.

Input fields

Name Description
appId (ID!)

The node ID of the application that owns the check suite.

setting (Boolean!)

Set to true to enable automatic creation of CheckSuite events upon pushes to the repository.


CheckSuiteFilter

The filters that are available when fetching check suites.

Input fields

Name Description
appId (Int)

Filters the check suites created by this application ID.

checkName (String)

Filters the check suites by this name.


ClearLabelsFromLabelableInput

Autogenerated input type of ClearLabelsFromLabelable

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

labelableId (ID!)

The id of the labelable object to clear the labels from.


CloneProjectInput

Autogenerated input type of CloneProject

Input fields

Name Description
body (String)

The description of the project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

includeWorkflows (Boolean!)

Whether or not to clone the source project’s workflows.

name (String!)

The name of the project.

public (Boolean)

The visibility of the project, defaults to false (private).

sourceId (ID!)

The source project to clone.

targetOwnerId (ID!)

The owner ID to create the project under.


CloneTemplateRepositoryInput

Autogenerated input type of CloneTemplateRepository

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

description (String)

A short description of the new repository.

includeAllBranches (Boolean)

Whether to copy all branches from the template to the new repository. Defaults to copying only the default branch of the template.

name (String!)

The name of the new repository.

ownerId (ID!)

The ID of the owner for the new repository.

repositoryId (ID!)

The Node ID of the template repository.

visibility (RepositoryVisibility!)

Indicates the repository’s visibility level.


CloseIssueInput

Autogenerated input type of CloseIssue

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

issueId (ID!)

ID of the issue to be closed.


ClosePullRequestInput

Autogenerated input type of ClosePullRequest

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestId (ID!)

ID of the pull request to be closed.


CommitAuthor

Specifies an author for filtering Git commits.

Input fields

Name Description
emails ([String!])

Email addresses to filter by. Commits authored by any of the specified email addresses will be returned.

id (ID)

ID of a User to filter by. If non-null, only commits authored by this user will be returned. This field takes precedence over emails.


CommitContributionOrder

Ordering options for commit contribution connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (CommitContributionOrderField!)

The field by which to order commit contributions.


CommitMessage

A message to include with a new commit

Input fields

Name Description
body (String)

The body of the message.

headline (String!)

The headline of the message.


CommittableBranch

A git ref for a commit to be appended to.

The ref must be a branch, i.e. its fully qualified name must start with refs/heads/ (although the input is not required to be fully qualified).

The Ref may be specified by its global node ID or by the repository nameWithOwner and branch name.

Examples

Specify a branch using a global node ID:

{ "id": "MDM6UmVmMTpyZWZzL2hlYWRzL21haW4=" }

Specify a branch using nameWithOwner and branch name:

{
  "nameWithOwner": "github/graphql-client",
  "branchName": "main"
}

Input fields

Name Description
branchName (String)

The unqualified name of the branch to append the commit to.

id (ID)

The Node ID of the Ref to be updated.

repositoryNameWithOwner (String)

The nameWithOwner of the repository to commit to.


ContributionOrder

Ordering options for contribution connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.


ConvertProjectCardNoteToIssueInput

Autogenerated input type of ConvertProjectCardNoteToIssue

Input fields

Name Description
body (String)

The body of the newly created issue.

clientMutationId (String)

A unique identifier for the client performing the mutation.

projectCardId (ID!)

The ProjectCard ID to convert.

repositoryId (ID!)

The ID of the repository to create the issue in.

title (String)

The title of the newly created issue. Defaults to the card’s note text.


ConvertPullRequestToDraftInput

Autogenerated input type of ConvertPullRequestToDraft

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestId (ID!)

ID of the pull request to convert to draft


CreateBranchProtectionRuleInput

Autogenerated input type of CreateBranchProtectionRule

Input fields

Name Description
allowsDeletions (Boolean)

Can this branch be deleted.

allowsForcePushes (Boolean)

Are force pushes allowed on this branch.

bypassForcePushActorIds ([ID!])

A list of User or Team IDs allowed to bypass force push targeting matching branches.

bypassPullRequestActorIds ([ID!])

A list of User or Team IDs allowed to bypass pull requests targeting matching branches.

clientMutationId (String)

A unique identifier for the client performing the mutation.

dismissesStaleReviews (Boolean)

Will new commits pushed to matching branches dismiss pull request review approvals.

isAdminEnforced (Boolean)

Can admins overwrite branch protection.

pattern (String!)

The glob-like pattern used to determine matching branches.

pushActorIds ([ID!])

A list of User, Team or App IDs allowed to push to matching branches.

repositoryId (ID!)

The global relay id of the repository in which a new branch protection rule should be created in.

requiredApprovingReviewCount (Int)

Number of approving reviews required to update matching branches.

requiredStatusCheckContexts ([String!])

List of required status check contexts that must pass for commits to be accepted to matching branches.

requiredStatusChecks ([RequiredStatusCheckInput!])

The list of required status checks

requiresApprovingReviews (Boolean)

Are approving reviews required to update matching branches.

requiresCodeOwnerReviews (Boolean)

Are reviews from code owners required to update matching branches.

requiresCommitSignatures (Boolean)

Are commits required to be signed.

requiresConversationResolution (Boolean)

Are conversations required to be resolved before merging.

requiresLinearHistory (Boolean)

Are merge commits prohibited from being pushed to this branch.

requiresStatusChecks (Boolean)

Are status checks required to update matching branches.

requiresStrictStatusChecks (Boolean)

Are branches required to be up to date before merging.

restrictsPushes (Boolean)

Is pushing to matching branches restricted.

restrictsReviewDismissals (Boolean)

Is dismissal of pull request reviews restricted.

reviewDismissalActorIds ([ID!])

A list of User or Team IDs allowed to dismiss reviews on pull requests targeting matching branches.


CreateCheckRunInput

Autogenerated input type of CreateCheckRun

Input fields

Name Description
actions ([CheckRunAction!])

Possible further actions the integrator can perform, which a user may trigger.

clientMutationId (String)

A unique identifier for the client performing the mutation.

completedAt (DateTime)

The time that the check run finished.

conclusion (CheckConclusionState)

The final conclusion of the check.

detailsUrl (URI)

The URL of the integrator’s site that has the full details of the check.

externalId (String)

A reference for the run on the integrator’s system.

headSha (GitObjectID!)

The SHA of the head commit.

name (String!)

The name of the check.

output (CheckRunOutput)

Descriptive details about the run.

repositoryId (ID!)

The node ID of the repository.

startedAt (DateTime)

The time that the check run began.

status (RequestableCheckStatusState)

The current status.


CreateCheckSuiteInput

Autogenerated input type of CreateCheckSuite

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

headSha (GitObjectID!)

The SHA of the head commit.

repositoryId (ID!)

The Node ID of the repository.


CreateCommitOnBranchInput

Autogenerated input type of CreateCommitOnBranch

Input fields

Name Description
branch (CommittableBranch!)

The Ref to be updated. Must be a branch.

clientMutationId (String)

A unique identifier for the client performing the mutation.

expectedHeadOid (GitObjectID!)

The git commit oid expected at the head of the branch prior to the commit

fileChanges (FileChanges)

A description of changes to files in this commit.

message (CommitMessage!)

The commit message the be included with the commit.


CreateDeploymentInput

Autogenerated input type of CreateDeployment

Input fields

Name Description
autoMerge (Boolean)

Attempt to automatically merge the default branch into the requested ref, defaults to true.

clientMutationId (String)

A unique identifier for the client performing the mutation.

description (String)

Short description of the deployment.

environment (String)

Name for the target deployment environment.

payload (String)

JSON payload with extra information about the deployment.

refId (ID!)

The node ID of the ref to be deployed.

repositoryId (ID!)

The node ID of the repository.

requiredContexts ([String!])

The status contexts to verify against commit status checks. To bypass required contexts, pass an empty array. Defaults to all unique contexts.

task (String)

Specifies a task to execute.


CreateDeploymentStatusInput

Autogenerated input type of CreateDeploymentStatus

Input fields

Name Description
autoInactive (Boolean)

Adds a new inactive status to all non-transient, non-production environment deployments with the same repository and environment name as the created status’s deployment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

deploymentId (ID!)

The node ID of the deployment.

description (String)

A short description of the status. Maximum length of 140 characters.

environment (String)

If provided, updates the environment of the deploy. Otherwise, does not modify the environment.

environmentUrl (String)

Sets the URL for accessing your environment.

logUrl (String)

The log URL to associate with this status. This URL should contain output to keep the user updated while the task is running or serve as historical information for what happened in the deployment.

state (DeploymentStatusState!)

The state of the deployment.


CreateDiscussionInput

Autogenerated input type of CreateDiscussion

Input fields

Name Description
body (String!)

The body of the discussion.

categoryId (ID!)

The id of the discussion category to associate with this discussion.

clientMutationId (String)

A unique identifier for the client performing the mutation.

repositoryId (ID!)

The id of the repository on which to create the discussion.

title (String!)

The title of the discussion.


CreateEnterpriseOrganizationInput

Autogenerated input type of CreateEnterpriseOrganization

Input fields

Name Description
adminLogins ([String!]!)

The logins for the administrators of the new organization.

billingEmail (String!)

The email used for sending billing receipts.

clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise owning the new organization.

login (String!)

The login of the new organization.

profileName (String!)

The profile name of the new organization.


CreateEnvironmentInput

Autogenerated input type of CreateEnvironment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of the environment.

repositoryId (ID!)

The node ID of the repository.


CreateIpAllowListEntryInput

Autogenerated input type of CreateIpAllowListEntry

Input fields

Name Description
allowListValue (String!)

An IP address or range of addresses in CIDR notation.

clientMutationId (String)

A unique identifier for the client performing the mutation.

isActive (Boolean!)

Whether the IP allow list entry is active when an IP allow list is enabled.

name (String)

An optional name for the IP allow list entry.

ownerId (ID!)

The ID of the owner for which to create the new IP allow list entry.


CreateIssueInput

Autogenerated input type of CreateIssue

Input fields

Name Description
assigneeIds ([ID!])

The Node ID for the user assignee for this issue.

body (String)

The body for the issue description.

clientMutationId (String)

A unique identifier for the client performing the mutation.

issueTemplate (String)

The name of an issue template in the repository, assigns labels and assignees from the template to the issue

labelIds ([ID!])

An array of Node IDs of labels for this issue.

milestoneId (ID)

The Node ID of the milestone for this issue.

projectIds ([ID!])

An array of Node IDs for projects associated with this issue.

repositoryId (ID!)

The Node ID of the repository.

title (String!)

The title for the issue.


CreateLabelInput

Autogenerated input type of CreateLabel

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

color (String!)

A 6 character hex code, without the leading #, identifying the color of the label.

description (String)

A brief description of the label, such as its purpose.

name (String!)

The name of the label.

repositoryId (ID!)

The Node ID of the repository.


CreateMigrationSourceInput

Autogenerated input type of CreateMigrationSource

Input fields

Name Description
accessToken (String!)

The Octoshift migration source access token.

clientMutationId (String)

A unique identifier for the client performing the mutation.

githubPat (String)

The GitHub personal access token of the user importing to the target repository.

name (String!)

The Octoshift migration source name.

ownerId (ID!)

The ID of the organization that will own the Octoshift migration source.

type (MigrationSourceType!)

The Octoshift migration source type.

url (String!)

The Octoshift migration source URL.


CreateProjectInput

Autogenerated input type of CreateProject

Input fields

Name Description
body (String)

The description of project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of project.

ownerId (ID!)

The owner ID to create the project under.

repositoryIds ([ID!])

A list of repository IDs to create as linked repositories for the project

template (ProjectTemplate)

The name of the GitHub-provided template.


CreatePullRequestInput

Autogenerated input type of CreatePullRequest

Input fields

Name Description
baseRefName (String!)

The name of the branch you want your changes pulled into. This should be an existing branch on the current repository. You cannot update the base branch on a pull request to point to another repository.

body (String)

The contents of the pull request.

clientMutationId (String)

A unique identifier for the client performing the mutation.

draft (Boolean)

Indicates whether this pull request should be a draft.

headRefName (String!)

The name of the branch where your changes are implemented. For cross-repository pull requests in the same network, namespace head_ref_name with a user like this: username:branch.

maintainerCanModify (Boolean)

Indicates whether maintainers can modify the pull request.

repositoryId (ID!)

The Node ID of the repository.

title (String!)

The title of the pull request.


CreateRefInput

Autogenerated input type of CreateRef

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The fully qualified name of the new Ref (ie: refs/heads/my_new_branch).

oid (GitObjectID!)

The GitObjectID that the new Ref shall target. Must point to a commit.

repositoryId (ID!)

The Node ID of the Repository to create the Ref in.


CreateRepositoryInput

Autogenerated input type of CreateRepository

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

description (String)

A short description of the new repository.

hasIssuesEnabled (Boolean)

Indicates if the repository should have the issues feature enabled.

hasWikiEnabled (Boolean)

Indicates if the repository should have the wiki feature enabled.

homepageUrl (URI)

The URL for a web page about this repository.

name (String!)

The name of the new repository.

ownerId (ID)

The ID of the owner for the new repository.

teamId (ID)

When an organization is specified as the owner, this ID identifies the team that should be granted access to the new repository.

template (Boolean)

Whether this repository should be marked as a template such that anyone who can access it can create new repositories with the same files and directory structure.

visibility (RepositoryVisibility!)

Indicates the repository’s visibility level.


CreateSponsorshipInput

Autogenerated input type of CreateSponsorship

Input fields

Name Description
amount (Int)

The amount to pay to the sponsorable in US dollars. Required if a tierId is not specified. Valid values: 1-12000.

clientMutationId (String)

A unique identifier for the client performing the mutation.

isRecurring (Boolean)

Whether the sponsorship should happen monthly/yearly or just this one time. Required if a tierId is not specified.

privacyLevel (SponsorshipPrivacy)

Specify whether others should be able to see that the sponsor is sponsoring the sponsorable. Public visibility still does not reveal which tier is used.

receiveEmails (Boolean)

Whether the sponsor should receive email updates from the sponsorable.

sponsorId (ID)

The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given.

sponsorLogin (String)

The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given.

sponsorableId (ID)

The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given.

sponsorableLogin (String)

The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given.

tierId (ID)

The ID of one of sponsorable’s existing tiers to sponsor at. Required if amount is not specified.


CreateTeamDiscussionCommentInput

Autogenerated input type of CreateTeamDiscussionComment

Input fields

Name Description
body (String!)

The content of the comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussionId (ID!)

The ID of the discussion to which the comment belongs.


CreateTeamDiscussionInput

Autogenerated input type of CreateTeamDiscussion

Input fields

Name Description
body (String!)

The content of the discussion.

clientMutationId (String)

A unique identifier for the client performing the mutation.

private (Boolean)

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

teamId (ID!)

The ID of the team to which the discussion belongs.

title (String!)

The title of the discussion.


DeclineTopicSuggestionInput

Autogenerated input type of DeclineTopicSuggestion

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of the suggested topic.

reason (TopicSuggestionDeclineReason!)

The reason why the suggested topic is declined.

repositoryId (ID!)

The Node ID of the repository.


DeleteBranchProtectionRuleInput

Autogenerated input type of DeleteBranchProtectionRule

Input fields

Name Description
branchProtectionRuleId (ID!)

The global relay id of the branch protection rule to be deleted.

clientMutationId (String)

A unique identifier for the client performing the mutation.


DeleteDeploymentInput

Autogenerated input type of DeleteDeployment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node ID of the deployment to be deleted.


DeleteDiscussionCommentInput

Autogenerated input type of DeleteDiscussionComment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node id of the discussion comment to delete.


DeleteDiscussionInput

Autogenerated input type of DeleteDiscussion

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The id of the discussion to delete.


DeleteEnvironmentInput

Autogenerated input type of DeleteEnvironment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node ID of the environment to be deleted.


DeleteIpAllowListEntryInput

Autogenerated input type of DeleteIpAllowListEntry

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

ipAllowListEntryId (ID!)

The ID of the IP allow list entry to delete.


DeleteIssueCommentInput

Autogenerated input type of DeleteIssueComment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the comment to delete.


DeleteIssueInput

Autogenerated input type of DeleteIssue

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

issueId (ID!)

The ID of the issue to delete.


DeleteLabelInput

Autogenerated input type of DeleteLabel

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node ID of the label to be deleted.


DeletePackageVersionInput

Autogenerated input type of DeletePackageVersion

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

packageVersionId (ID!)

The ID of the package version to be deleted.


DeleteProjectCardInput

Autogenerated input type of DeleteProjectCard

Input fields

Name Description
cardId (ID!)

The id of the card to delete.

clientMutationId (String)

A unique identifier for the client performing the mutation.


DeleteProjectColumnInput

Autogenerated input type of DeleteProjectColumn

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

columnId (ID!)

The id of the column to delete.


DeleteProjectInput

Autogenerated input type of DeleteProject

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The Project ID to update.


DeleteProjectNextItemInput

Autogenerated input type of DeleteProjectNextItem

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

itemId (ID!)

The ID of the item to be removed.

projectId (ID!)

The ID of the Project from which the item should be removed.


DeletePullRequestReviewCommentInput

Autogenerated input type of DeletePullRequestReviewComment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the comment to delete.


DeletePullRequestReviewInput

Autogenerated input type of DeletePullRequestReview

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestReviewId (ID!)

The Node ID of the pull request review to delete.


DeleteRefInput

Autogenerated input type of DeleteRef

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

refId (ID!)

The Node ID of the Ref to be deleted.


DeleteTeamDiscussionCommentInput

Autogenerated input type of DeleteTeamDiscussionComment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the comment to delete.


DeleteTeamDiscussionInput

Autogenerated input type of DeleteTeamDiscussion

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The discussion ID to delete.


DeleteVerifiableDomainInput

Autogenerated input type of DeleteVerifiableDomain

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the verifiable domain to delete.


DeploymentOrder

Ordering options for deployment connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (DeploymentOrderField!)

The field to order deployments by.


DisablePullRequestAutoMergeInput

Autogenerated input type of DisablePullRequestAutoMerge

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestId (ID!)

ID of the pull request to disable auto merge on.


DiscussionOrder

Ways in which lists of discussions can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order discussions by the specified field.

field (DiscussionOrderField!)

The field by which to order discussions.


DismissPullRequestReviewInput

Autogenerated input type of DismissPullRequestReview

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

message (String!)

The contents of the pull request review dismissal message.

pullRequestReviewId (ID!)

The Node ID of the pull request review to modify.


DismissRepositoryVulnerabilityAlertInput

Autogenerated input type of DismissRepositoryVulnerabilityAlert

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

dismissReason (DismissReason!)

The reason the Dependabot alert is being dismissed.

repositoryVulnerabilityAlertId (ID!)

The Dependabot alert ID to dismiss.


DraftPullRequestReviewComment

Specifies a review comment to be left with a Pull Request Review.

Input fields

Name Description
body (String!)

Body of the comment to leave.

path (String!)

Path to the file being commented on.

position (Int!)

Position in the file to leave a comment on.


DraftPullRequestReviewThread

Specifies a review comment thread to be left with a Pull Request Review.

Input fields

Name Description
body (String!)

Body of the comment to leave.

line (Int!)

The line of the blob to which the thread refers. The end of the line range for multi-line comments.

path (String!)

Path to the file being commented on.

side (DiffSide)

The side of the diff on which the line resides. For multi-line comments, this is the side for the end of the line range.

startLine (Int)

The first line of the range to which the comment refers.

startSide (DiffSide)

The side of the diff on which the start line resides.


EnablePullRequestAutoMergeInput

Autogenerated input type of EnablePullRequestAutoMerge

Input fields

Name Description
authorEmail (String)

The email address to associate with this merge.

clientMutationId (String)

A unique identifier for the client performing the mutation.

commitBody (String)

Commit body to use for the commit when the PR is mergable; if omitted, a default message will be used.

commitHeadline (String)

Commit headline to use for the commit when the PR is mergable; if omitted, a default message will be used.

mergeMethod (PullRequestMergeMethod)

The merge method to use. If omitted, defaults to ‘MERGE’

pullRequestId (ID!)

ID of the pull request to enable auto-merge on.


EnterpriseAdministratorInvitationOrder

Ordering options for enterprise administrator invitation connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (EnterpriseAdministratorInvitationOrderField!)

The field to order enterprise administrator invitations by.


EnterpriseMemberOrder

Ordering options for enterprise member connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (EnterpriseMemberOrderField!)

The field to order enterprise members by.


EnterpriseServerInstallationOrder

Ordering options for Enterprise Server installation connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (EnterpriseServerInstallationOrderField!)

The field to order Enterprise Server installations by.


EnterpriseServerUserAccountEmailOrder

Ordering options for Enterprise Server user account email connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (EnterpriseServerUserAccountEmailOrderField!)

The field to order emails by.


EnterpriseServerUserAccountOrder

Ordering options for Enterprise Server user account connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (EnterpriseServerUserAccountOrderField!)

The field to order user accounts by.


EnterpriseServerUserAccountsUploadOrder

Ordering options for Enterprise Server user accounts upload connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (EnterpriseServerUserAccountsUploadOrderField!)

The field to order user accounts uploads by.


FileAddition

A command to add a file at the given path with the given contents as part of a commit. Any existing file at that that path will be replaced.

Input fields

Name Description
contents (Base64String!)

The base64 encoded contents of the file

path (String!)

The path in the repository where the file will be located


FileChanges

A description of a set of changes to a file tree to be made as part of a git commit, modeled as zero or more file additions and zero or more file deletions.

Both fields are optional; omitting both will produce a commit with no file changes.

deletions and additions describe changes to files identified by their path in the git tree using unix-style path separators, i.e. /. The root of a git tree is an empty string, so paths are not slash-prefixed.

path values must be unique across all additions and deletions provided. Any duplication will result in a validation error.

Encoding

File contents must be provided in full for each FileAddition.

The contents of a FileAddition must be encoded using RFC 4648 compliant base64, i.e. correct padding is required and no characters outside the standard alphabet may be used. Invalid base64 encoding will be rejected with a validation error.

The encoded contents may be binary.

For text files, no assumptions are made about the character encoding of the file contents (after base64 decoding). No charset transcoding or line-ending normalization will be performed; it is the client’s responsibility to manage the character encoding of files they provide. However, for maximum compatibility we recommend using UTF-8 encoding and ensuring that all files in a repository use a consistent line-ending convention (\n or \r\n), and that all files end with a newline.

Modeling file changes

Each of the the five types of conceptual changes that can be made in a git commit can be described using the FileChanges type as follows:

  1. New file addition: create file hello world\n at path docs/README.txt:

    { “additions” [ { “path”: “docs/README.txt”, “contents”: base64encode(“hello world\n”) } ] }

  2. Existing file modification: change existing docs/README.txt to have new content new content here\n:

    { “additions” [ { “path”: “docs/README.txt”, “contents”: base64encode(“new content here\n”) } ] }

  3. Existing file deletion: remove existing file docs/README.txt. Note that the path is required to exist – specifying a path that does not exist on the given branch will abort the commit and return an error.

    { “deletions” [ { “path”: “docs/README.txt” } ] }

  4. File rename with no changes: rename docs/README.txt with previous content hello world\n to the same content at newdocs/README.txt:

    { “deletions” [ { “path”: “docs/README.txt”, } ], “additions” [ { “path”: “newdocs/README.txt”, “contents”: base64encode(“hello world\n”) } ] }

  5. File rename with changes: rename docs/README.txt with previous content hello world\n to a file at path newdocs/README.txt with content new contents\n:

    { “deletions” [ { “path”: “docs/README.txt”, } ], “additions” [ { “path”: “newdocs/README.txt”, “contents”: base64encode(“new contents\n”) } ] }

Input fields

Name Description
additions ([FileAddition!])

File to add or change.

deletions ([FileDeletion!])

Files to delete.


FileDeletion

A command to delete the file at the given path as part of a commit.

Input fields

Name Description
path (String!)

The path to delete


FollowUserInput

Autogenerated input type of FollowUser

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

userId (ID!)

ID of the user to follow.


GistOrder

Ordering options for gist connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (GistOrderField!)

The field to order repositories by.


GrantEnterpriseOrganizationsMigratorRoleInput

Autogenerated input type of GrantEnterpriseOrganizationsMigratorRole

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise to which all organizations managed by it will be granted the migrator role.

login (String!)

The login of the user to grant the migrator role


GrantMigratorRoleInput

Autogenerated input type of GrantMigratorRole

Input fields

Name Description
actor (String!)

The user login or Team slug to grant the migrator role.

actorType (ActorType!)

Specifies the type of the actor, can be either USER or TEAM.

clientMutationId (String)

A unique identifier for the client performing the mutation.

organizationId (ID!)

The ID of the organization that the user/team belongs to.


ImportProjectInput

Autogenerated input type of ImportProject

Input fields

Name Description
body (String)

The description of Project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnImports ([ProjectColumnImport!]!)

A list of columns containing issues and pull requests.

name (String!)

The name of Project.

ownerName (String!)

The name of the Organization or User to create the Project under.

public (Boolean)

Whether the Project is public or not.


InviteEnterpriseAdminInput

Autogenerated input type of InviteEnterpriseAdmin

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

email (String)

The email of the person to invite as an administrator.

enterpriseId (ID!)

The ID of the enterprise to which you want to invite an administrator.

invitee (String)

The login of a user to invite as an administrator.

role (EnterpriseAdministratorRole)

The role of the administrator.


IpAllowListEntryOrder

Ordering options for IP allow list entry connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (IpAllowListEntryOrderField!)

The field to order IP allow list entries by.


IssueCommentOrder

Ways in which lists of issue comments can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order issue comments by the specified field.

field (IssueCommentOrderField!)

The field in which to order issue comments by.


IssueFilters

Ways in which to filter lists of issues.

Input fields

Name Description
assignee (String)

List issues assigned to given name. Pass in null for issues with no assigned user, and * for issues assigned to any user.

createdBy (String)

List issues created by given name.

labels ([String!])

List issues where the list of label names exist on the issue.

mentioned (String)

List issues where the given name is mentioned in the issue.

milestone (String)

List issues by given milestone argument. If an string representation of an integer is passed, it should refer to a milestone by its database ID. Pass in null for issues with no milestone, and * for issues that are assigned to any milestone.

milestoneNumber (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.

since (DateTime)

List issues that have been updated at or after the given date.

states ([IssueState!])

List issues filtered by the list of states given.

viewerSubscribed (Boolean)

List issues subscribed to by viewer.


IssueOrder

Ways in which lists of issues can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order issues by the specified field.

field (IssueOrderField!)

The field in which to order issues by.


LabelOrder

Ways in which lists of labels can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order labels by the specified field.

field (LabelOrderField!)

The field in which to order labels by.


LanguageOrder

Ordering options for language connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (LanguageOrderField!)

The field to order languages by.


LinkRepositoryToProjectInput

Autogenerated input type of LinkRepositoryToProject

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project to link to a Repository

repositoryId (ID!)

The ID of the Repository to link to a Project.


LockLockableInput

Autogenerated input type of LockLockable

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

lockReason (LockReason)

A reason for why the item will be locked.

lockableId (ID!)

ID of the item to be locked.


MarkDiscussionCommentAsAnswerInput

Autogenerated input type of MarkDiscussionCommentAsAnswer

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node ID of the discussion comment to mark as an answer.


MarkFileAsViewedInput

Autogenerated input type of MarkFileAsViewed

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

path (String!)

The path of the file to mark as viewed

pullRequestId (ID!)

The Node ID of the pull request.


MarkPullRequestReadyForReviewInput

Autogenerated input type of MarkPullRequestReadyForReview

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestId (ID!)

ID of the pull request to be marked as ready for review.


MergeBranchInput

Autogenerated input type of MergeBranch

Input fields

Name Description
authorEmail (String)

The email address to associate with this commit.

base (String!)

The name of the base branch that the provided head will be merged into.

clientMutationId (String)

A unique identifier for the client performing the mutation.

commitMessage (String)

Message to use for the merge commit. If omitted, a default will be used.

head (String!)

The head to merge into the base branch. This can be a branch name or a commit GitObjectID.

repositoryId (ID!)

The Node ID of the Repository containing the base branch that will be modified.


MergePullRequestInput

Autogenerated input type of MergePullRequest

Input fields

Name Description
authorEmail (String)

The email address to associate with this merge.

clientMutationId (String)

A unique identifier for the client performing the mutation.

commitBody (String)

Commit body to use for the merge commit; if omitted, a default message will be used

commitHeadline (String)

Commit headline to use for the merge commit; if omitted, a default message will be used.

expectedHeadOid (GitObjectID)

OID that the pull request head ref must match to allow merge; if omitted, no check is performed.

mergeMethod (PullRequestMergeMethod)

The merge method to use. If omitted, defaults to ‘MERGE’

pullRequestId (ID!)

ID of the pull request to be merged.


MilestoneOrder

Ordering options for milestone connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (MilestoneOrderField!)

The field to order milestones by.


MinimizeCommentInput

Autogenerated input type of MinimizeComment

Input fields

Name Description
classifier (ReportedContentClassifiers!)

The classification of comment

clientMutationId (String)

A unique identifier for the client performing the mutation.

subjectId (ID!)

The Node ID of the subject to modify.


MoveProjectCardInput

Autogenerated input type of MoveProjectCard

Input fields

Name Description
afterCardId (ID)

Place the new card after the card with this id. Pass null to place it at the top.

cardId (ID!)

The id of the card to move.

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnId (ID!)

The id of the column to move it into.


MoveProjectColumnInput

Autogenerated input type of MoveProjectColumn

Input fields

Name Description
afterColumnId (ID)

Place the new column after the column with this id. Pass null to place it at the front.

clientMutationId (String)

A unique identifier for the client performing the mutation.

columnId (ID!)

The id of the column to move.


OrgEnterpriseOwnerOrder

Ordering options for an organization’s enterprise owner connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (OrgEnterpriseOwnerOrderField!)

The field to order enterprise owners by.


OrganizationOrder

Ordering options for organization connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (OrganizationOrderField!)

The field to order organizations by.


PackageFileOrder

Ways in which lists of package files can be ordered upon return.

Input fields

Name Description
direction (OrderDirection)

The direction in which to order package files by the specified field.

field (PackageFileOrderField)

The field in which to order package files by.


PackageOrder

Ways in which lists of packages can be ordered upon return.

Input fields

Name Description
direction (OrderDirection)

The direction in which to order packages by the specified field.

field (PackageOrderField)

The field in which to order packages by.


PackageVersionOrder

Ways in which lists of package versions can be ordered upon return.

Input fields

Name Description
direction (OrderDirection)

The direction in which to order package versions by the specified field.

field (PackageVersionOrderField)

The field in which to order package versions by.


PinIssueInput

Autogenerated input type of PinIssue

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

issueId (ID!)

The ID of the issue to be pinned


ProjectCardImport

An issue or PR and its owning repository to be used in a project card.

Input fields

Name Description
number (Int!)

The issue or pull request number.

repository (String!)

Repository name with owner (owner/repository).


ProjectColumnImport

A project column and a list of its issues and PRs.

Input fields

Name Description
columnName (String!)

The name of the column.

issues ([ProjectCardImport!])

A list of issues and pull requests in the column.

position (Int!)

The position of the column, starting from 0.


ProjectOrder

Ways in which lists of projects can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order projects by the specified field.

field (ProjectOrderField!)

The field in which to order projects by.


PullRequestOrder

Ways in which lists of issues can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order pull requests by the specified field.

field (PullRequestOrderField!)

The field in which to order pull requests by.


ReactionOrder

Ways in which lists of reactions can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order reactions by the specified field.

field (ReactionOrderField!)

The field in which to order reactions by.


RefOrder

Ways in which lists of git refs can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order refs by the specified field.

field (RefOrderField!)

The field in which to order refs by.


RefUpdate

A ref update

Input fields

Name Description
afterOid (GitObjectID!)

The value this ref should be updated to.

beforeOid (GitObjectID)

The value this ref needs to point to before the update.

force (Boolean)

Force a non fast-forward update.

name (GitRefname!)

The fully qualified name of the ref to be update. For example refs/heads/branch-name


RegenerateEnterpriseIdentityProviderRecoveryCodesInput

Autogenerated input type of RegenerateEnterpriseIdentityProviderRecoveryCodes

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set an identity provider.


RegenerateVerifiableDomainTokenInput

Autogenerated input type of RegenerateVerifiableDomainToken

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the verifiable domain to regenerate the verification token of.


RejectDeploymentsInput

Autogenerated input type of RejectDeployments

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

comment (String)

Optional comment for rejecting deployments

environmentIds ([ID!]!)

The ids of environments to reject deployments

workflowRunId (ID!)

The node ID of the workflow run containing the pending deployments.


ReleaseOrder

Ways in which lists of releases can be ordered upon return.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order releases by the specified field.

field (ReleaseOrderField!)

The field in which to order releases by.


RemoveAssigneesFromAssignableInput

Autogenerated input type of RemoveAssigneesFromAssignable

Input fields

Name Description
assignableId (ID!)

The id of the assignable object to remove assignees from.

assigneeIds ([ID!]!)

The id of users to remove as assignees.

clientMutationId (String)

A unique identifier for the client performing the mutation.


RemoveEnterpriseAdminInput

Autogenerated input type of RemoveEnterpriseAdmin

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The Enterprise ID from which to remove the administrator.

login (String!)

The login of the user to remove as an administrator.


RemoveEnterpriseIdentityProviderInput

Autogenerated input type of RemoveEnterpriseIdentityProvider

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise from which to remove the identity provider.


RemoveEnterpriseOrganizationInput

Autogenerated input type of RemoveEnterpriseOrganization

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise from which the organization should be removed.

organizationId (ID!)

The ID of the organization to remove from the enterprise.


RemoveEnterpriseSupportEntitlementInput

Autogenerated input type of RemoveEnterpriseSupportEntitlement

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the Enterprise which the admin belongs to.

login (String!)

The login of a member who will lose the support entitlement.


RemoveLabelsFromLabelableInput

Autogenerated input type of RemoveLabelsFromLabelable

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

labelIds ([ID!]!)

The ids of labels to remove.

labelableId (ID!)

The id of the Labelable to remove labels from.


RemoveOutsideCollaboratorInput

Autogenerated input type of RemoveOutsideCollaborator

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

organizationId (ID!)

The ID of the organization to remove the outside collaborator from.

userId (ID!)

The ID of the outside collaborator to remove.


RemoveReactionInput

Autogenerated input type of RemoveReaction

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

content (ReactionContent!)

The name of the emoji reaction to remove.

subjectId (ID!)

The Node ID of the subject to modify.


RemoveStarInput

Autogenerated input type of RemoveStar

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

starrableId (ID!)

The Starrable ID to unstar.


RemoveUpvoteInput

Autogenerated input type of RemoveUpvote

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

subjectId (ID!)

The Node ID of the discussion or comment to remove upvote.


ReopenIssueInput

Autogenerated input type of ReopenIssue

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

issueId (ID!)

ID of the issue to be opened.


ReopenPullRequestInput

Autogenerated input type of ReopenPullRequest

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestId (ID!)

ID of the pull request to be reopened.


RepositoryInvitationOrder

Ordering options for repository invitation connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (RepositoryInvitationOrderField!)

The field to order repository invitations by.


RepositoryMigrationOrder

Ordering options for repository migrations.

Input fields

Name Description
direction (RepositoryMigrationOrderDirection!)

The ordering direction.

field (RepositoryMigrationOrderField!)

The field to order repository migrations by.


RepositoryOrder

Ordering options for repository connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (RepositoryOrderField!)

The field to order repositories by.


RequestReviewsInput

Autogenerated input type of RequestReviews

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestId (ID!)

The Node ID of the pull request to modify.

teamIds ([ID!])

The Node IDs of the team to request.

union (Boolean)

Add users to the set rather than replace.

userIds ([ID!])

The Node IDs of the user to request.


RequiredStatusCheckInput

Specifies the attributes for a new or updated required status check.

Input fields

Name Description
appId (ID)

The ID of the App that must set the status in order for it to be accepted. Omit this value to use whichever app has recently been setting this status, or use “any” to allow any app to set the status.

context (String!)

Status check context that must pass for commits to be accepted to the matching branch.


RerequestCheckSuiteInput

Autogenerated input type of RerequestCheckSuite

Input fields

Name Description
checkSuiteId (ID!)

The Node ID of the check suite.

clientMutationId (String)

A unique identifier for the client performing the mutation.

repositoryId (ID!)

The Node ID of the repository.


ResolveReviewThreadInput

Autogenerated input type of ResolveReviewThread

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

threadId (ID!)

The ID of the thread to resolve


RevokeEnterpriseOrganizationsMigratorRoleInput

Autogenerated input type of RevokeEnterpriseOrganizationsMigratorRole

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise to which all organizations managed by it will be granted the migrator role.

login (String!)

The login of the user to revoke the migrator role


RevokeMigratorRoleInput

Autogenerated input type of RevokeMigratorRole

Input fields

Name Description
actor (String!)

The user login or Team slug to revoke the migrator role from.

actorType (ActorType!)

Specifies the type of the actor, can be either USER or TEAM.

clientMutationId (String)

A unique identifier for the client performing the mutation.

organizationId (ID!)

The ID of the organization that the user/team belongs to.


SavedReplyOrder

Ordering options for saved reply connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SavedReplyOrderField!)

The field to order saved replies by.


SecurityAdvisoryIdentifierFilter

An advisory identifier to filter results on.

Input fields

Name Description
type (SecurityAdvisoryIdentifierType!)

The identifier type.

value (String!)

The identifier string. Supports exact or partial matching.


SecurityAdvisoryOrder

Ordering options for security advisory connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SecurityAdvisoryOrderField!)

The field to order security advisories by.


SecurityVulnerabilityOrder

Ordering options for security vulnerability connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SecurityVulnerabilityOrderField!)

The field to order security vulnerabilities by.


SetEnterpriseIdentityProviderInput

Autogenerated input type of SetEnterpriseIdentityProvider

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

digestMethod (SamlDigestAlgorithm!)

The digest algorithm used to sign SAML requests for the identity provider.

enterpriseId (ID!)

The ID of the enterprise on which to set an identity provider.

idpCertificate (String!)

The x509 certificate used by the identity provider to sign assertions and responses.

issuer (String)

The Issuer Entity ID for the SAML identity provider

signatureMethod (SamlSignatureAlgorithm!)

The signature algorithm used to sign SAML requests for the identity provider.

ssoUrl (URI!)

The URL endpoint for the identity provider’s SAML SSO.


SetOrganizationInteractionLimitInput

Autogenerated input type of SetOrganizationInteractionLimit

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

expiry (RepositoryInteractionLimitExpiry)

When this limit should expire.

limit (RepositoryInteractionLimit!)

The limit to set.

organizationId (ID!)

The ID of the organization to set a limit for.


SetRepositoryInteractionLimitInput

Autogenerated input type of SetRepositoryInteractionLimit

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

expiry (RepositoryInteractionLimitExpiry)

When this limit should expire.

limit (RepositoryInteractionLimit!)

The limit to set.

repositoryId (ID!)

The ID of the repository to set a limit for.


SetUserInteractionLimitInput

Autogenerated input type of SetUserInteractionLimit

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

expiry (RepositoryInteractionLimitExpiry)

When this limit should expire.

limit (RepositoryInteractionLimit!)

The limit to set.

userId (ID!)

The ID of the user to set a limit for.


SponsorOrder

Ordering options for connections to get sponsor entities for GitHub Sponsors.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SponsorOrderField!)

The field to order sponsor entities by.


SponsorableOrder

Ordering options for connections to get sponsorable entities for GitHub Sponsors.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SponsorableOrderField!)

The field to order sponsorable entities by.


SponsorsActivityOrder

Ordering options for GitHub Sponsors activity connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SponsorsActivityOrderField!)

The field to order activity by.


SponsorsTierOrder

Ordering options for Sponsors tiers connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SponsorsTierOrderField!)

The field to order tiers by.


SponsorshipNewsletterOrder

Ordering options for sponsorship newsletter connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SponsorshipNewsletterOrderField!)

The field to order sponsorship newsletters by.


SponsorshipOrder

Ordering options for sponsorship connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (SponsorshipOrderField!)

The field to order sponsorship by.


StarOrder

Ways in which star connections can be ordered.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order nodes.

field (StarOrderField!)

The field in which to order nodes by.


StartRepositoryMigrationInput

Autogenerated input type of StartRepositoryMigration

Input fields

Name Description
accessToken (String)

The Octoshift migration source access token.

clientMutationId (String)

A unique identifier for the client performing the mutation.

continueOnError (Boolean)

Whether to continue the migration on error

gitArchiveUrl (String)

The signed URL to access the user-uploaded git archive

githubPat (String)

The GitHub personal access token of the user importing to the target repository.

metadataArchiveUrl (String)

The signed URL to access the user-uploaded metadata archive

ownerId (ID!)

The ID of the organization that will own the imported repository.

repositoryName (String!)

The name of the imported repository.

sourceId (ID!)

The ID of the Octoshift migration source.

sourceRepositoryUrl (URI!)

The Octoshift migration source repository URL.


SubmitPullRequestReviewInput

Autogenerated input type of SubmitPullRequestReview

Input fields

Name Description
body (String)

The text field to set on the Pull Request Review.

clientMutationId (String)

A unique identifier for the client performing the mutation.

event (PullRequestReviewEvent!)

The event to send to the Pull Request Review.

pullRequestId (ID)

The Pull Request ID to submit any pending reviews.

pullRequestReviewId (ID)

The Pull Request Review ID to submit.


TeamDiscussionCommentOrder

Ways in which team discussion comment connections can be ordered.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order nodes.

field (TeamDiscussionCommentOrderField!)

The field by which to order nodes.


TeamDiscussionOrder

Ways in which team discussion connections can be ordered.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order nodes.

field (TeamDiscussionOrderField!)

The field by which to order nodes.


TeamMemberOrder

Ordering options for team member connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (TeamMemberOrderField!)

The field to order team members by.


TeamOrder

Ways in which team connections can be ordered.

Input fields

Name Description
direction (OrderDirection!)

The direction in which to order nodes.

field (TeamOrderField!)

The field in which to order nodes by.


TeamRepositoryOrder

Ordering options for team repository connections

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (TeamRepositoryOrderField!)

The field to order repositories by.


TransferIssueInput

Autogenerated input type of TransferIssue

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

issueId (ID!)

The Node ID of the issue to be transferred

repositoryId (ID!)

The Node ID of the repository the issue should be transferred to


UnarchiveRepositoryInput

Autogenerated input type of UnarchiveRepository

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

repositoryId (ID!)

The ID of the repository to unarchive.


UnfollowUserInput

Autogenerated input type of UnfollowUser

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

userId (ID!)

ID of the user to unfollow.


UnlinkRepositoryFromProjectInput

Autogenerated input type of UnlinkRepositoryFromProject

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

projectId (ID!)

The ID of the Project linked to the Repository.

repositoryId (ID!)

The ID of the Repository linked to the Project.


UnlockLockableInput

Autogenerated input type of UnlockLockable

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

lockableId (ID!)

ID of the item to be unlocked.


UnmarkDiscussionCommentAsAnswerInput

Autogenerated input type of UnmarkDiscussionCommentAsAnswer

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node ID of the discussion comment to unmark as an answer.


UnmarkFileAsViewedInput

Autogenerated input type of UnmarkFileAsViewed

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

path (String!)

The path of the file to mark as unviewed

pullRequestId (ID!)

The Node ID of the pull request.


UnmarkIssueAsDuplicateInput

Autogenerated input type of UnmarkIssueAsDuplicate

Input fields

Name Description
canonicalId (ID!)

ID of the issue or pull request currently considered canonical/authoritative/original.

clientMutationId (String)

A unique identifier for the client performing the mutation.

duplicateId (ID!)

ID of the issue or pull request currently marked as a duplicate.


UnminimizeCommentInput

Autogenerated input type of UnminimizeComment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

subjectId (ID!)

The Node ID of the subject to modify.


UnpinIssueInput

Autogenerated input type of UnpinIssue

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

issueId (ID!)

The ID of the issue to be unpinned


UnresolveReviewThreadInput

Autogenerated input type of UnresolveReviewThread

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

threadId (ID!)

The ID of the thread to unresolve


UpdateBranchProtectionRuleInput

Autogenerated input type of UpdateBranchProtectionRule

Input fields

Name Description
allowsDeletions (Boolean)

Can this branch be deleted.

allowsForcePushes (Boolean)

Are force pushes allowed on this branch.

branchProtectionRuleId (ID!)

The global relay id of the branch protection rule to be updated.

bypassForcePushActorIds ([ID!])

A list of User or Team IDs allowed to bypass force push targeting matching branches.

bypassPullRequestActorIds ([ID!])

A list of User or Team IDs allowed to bypass pull requests targeting matching branches.

clientMutationId (String)

A unique identifier for the client performing the mutation.

dismissesStaleReviews (Boolean)

Will new commits pushed to matching branches dismiss pull request review approvals.

isAdminEnforced (Boolean)

Can admins overwrite branch protection.

pattern (String)

The glob-like pattern used to determine matching branches.

pushActorIds ([ID!])

A list of User, Team or App IDs allowed to push to matching branches.

requiredApprovingReviewCount (Int)

Number of approving reviews required to update matching branches.

requiredStatusCheckContexts ([String!])

List of required status check contexts that must pass for commits to be accepted to matching branches.

requiredStatusChecks ([RequiredStatusCheckInput!])

The list of required status checks

requiresApprovingReviews (Boolean)

Are approving reviews required to update matching branches.

requiresCodeOwnerReviews (Boolean)

Are reviews from code owners required to update matching branches.

requiresCommitSignatures (Boolean)

Are commits required to be signed.

requiresConversationResolution (Boolean)

Are conversations required to be resolved before merging.

requiresLinearHistory (Boolean)

Are merge commits prohibited from being pushed to this branch.

requiresStatusChecks (Boolean)

Are status checks required to update matching branches.

requiresStrictStatusChecks (Boolean)

Are branches required to be up to date before merging.

restrictsPushes (Boolean)

Is pushing to matching branches restricted.

restrictsReviewDismissals (Boolean)

Is dismissal of pull request reviews restricted.

reviewDismissalActorIds ([ID!])

A list of User or Team IDs allowed to dismiss reviews on pull requests targeting matching branches.


UpdateCheckRunInput

Autogenerated input type of UpdateCheckRun

Input fields

Name Description
actions ([CheckRunAction!])

Possible further actions the integrator can perform, which a user may trigger.

checkRunId (ID!)

The node of the check.

clientMutationId (String)

A unique identifier for the client performing the mutation.

completedAt (DateTime)

The time that the check run finished.

conclusion (CheckConclusionState)

The final conclusion of the check.

detailsUrl (URI)

The URL of the integrator’s site that has the full details of the check.

externalId (String)

A reference for the run on the integrator’s system.

name (String)

The name of the check.

output (CheckRunOutput)

Descriptive details about the run.

repositoryId (ID!)

The node ID of the repository.

startedAt (DateTime)

The time that the check run began.

status (RequestableCheckStatusState)

The current status.


UpdateCheckSuitePreferencesInput

Autogenerated input type of UpdateCheckSuitePreferences

Input fields

Name Description
autoTriggerPreferences ([CheckSuiteAutoTriggerPreference!]!)

The check suite preferences to modify.

clientMutationId (String)

A unique identifier for the client performing the mutation.

repositoryId (ID!)

The Node ID of the repository.


UpdateDiscussionCommentInput

Autogenerated input type of UpdateDiscussionComment

Input fields

Name Description
body (String!)

The new contents of the comment body.

clientMutationId (String)

A unique identifier for the client performing the mutation.

commentId (ID!)

The Node ID of the discussion comment to update.


UpdateDiscussionInput

Autogenerated input type of UpdateDiscussion

Input fields

Name Description
body (String)

The new contents of the discussion body.

categoryId (ID)

The Node ID of a discussion category within the same repository to change this discussion to.

clientMutationId (String)

A unique identifier for the client performing the mutation.

discussionId (ID!)

The Node ID of the discussion to update.

title (String)

The new discussion title.


UpdateEnterpriseAdministratorRoleInput

Autogenerated input type of UpdateEnterpriseAdministratorRole

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the Enterprise which the admin belongs to.

login (String!)

The login of a administrator whose role is being changed.

role (EnterpriseAdministratorRole!)

The new role for the Enterprise administrator.


UpdateEnterpriseAllowPrivateRepositoryForkingSettingInput

Autogenerated input type of UpdateEnterpriseAllowPrivateRepositoryForkingSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the allow private repository forking setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the allow private repository forking setting on the enterprise.


UpdateEnterpriseDefaultRepositoryPermissionSettingInput

Autogenerated input type of UpdateEnterpriseDefaultRepositoryPermissionSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the base repository permission setting.

settingValue (EnterpriseDefaultRepositoryPermissionSettingValue!)

The value for the base repository permission setting on the enterprise.


UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingInput

Autogenerated input type of UpdateEnterpriseMembersCanChangeRepositoryVisibilitySetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can change repository visibility setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the members can change repository visibility setting on the enterprise.


UpdateEnterpriseMembersCanCreateRepositoriesSettingInput

Autogenerated input type of UpdateEnterpriseMembersCanCreateRepositoriesSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can create repositories setting.

membersCanCreateInternalRepositories (Boolean)

Allow members to create internal repositories. Defaults to current value.

membersCanCreatePrivateRepositories (Boolean)

Allow members to create private repositories. Defaults to current value.

membersCanCreatePublicRepositories (Boolean)

Allow members to create public repositories. Defaults to current value.

membersCanCreateRepositoriesPolicyEnabled (Boolean)

When false, allow member organizations to set their own repository creation member privileges.

settingValue (EnterpriseMembersCanCreateRepositoriesSettingValue)

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.


UpdateEnterpriseMembersCanDeleteIssuesSettingInput

Autogenerated input type of UpdateEnterpriseMembersCanDeleteIssuesSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can delete issues setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the members can delete issues setting on the enterprise.


UpdateEnterpriseMembersCanDeleteRepositoriesSettingInput

Autogenerated input type of UpdateEnterpriseMembersCanDeleteRepositoriesSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can delete repositories setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the members can delete repositories setting on the enterprise.


UpdateEnterpriseMembersCanInviteCollaboratorsSettingInput

Autogenerated input type of UpdateEnterpriseMembersCanInviteCollaboratorsSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can invite collaborators setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the members can invite collaborators setting on the enterprise.


UpdateEnterpriseMembersCanMakePurchasesSettingInput

Autogenerated input type of UpdateEnterpriseMembersCanMakePurchasesSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can make purchases setting.

settingValue (EnterpriseMembersCanMakePurchasesSettingValue!)

The value for the members can make purchases setting on the enterprise.


UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingInput

Autogenerated input type of UpdateEnterpriseMembersCanUpdateProtectedBranchesSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can update protected branches setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the members can update protected branches setting on the enterprise.


UpdateEnterpriseMembersCanViewDependencyInsightsSettingInput

Autogenerated input type of UpdateEnterpriseMembersCanViewDependencyInsightsSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the members can view dependency insights setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the members can view dependency insights setting on the enterprise.


UpdateEnterpriseOrganizationProjectsSettingInput

Autogenerated input type of UpdateEnterpriseOrganizationProjectsSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the organization projects setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the organization projects setting on the enterprise.


UpdateEnterpriseOwnerOrganizationRoleInput

Autogenerated input type of UpdateEnterpriseOwnerOrganizationRole

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the Enterprise which the owner belongs to.

organizationId (ID!)

The ID of the organization for membership change.

organizationRole (RoleInOrganization!)

The role to assume in the organization.


UpdateEnterpriseProfileInput

Autogenerated input type of UpdateEnterpriseProfile

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

description (String)

The description of the enterprise.

enterpriseId (ID!)

The Enterprise ID to update.

location (String)

The location of the enterprise.

name (String)

The name of the enterprise.

websiteUrl (String)

The URL of the enterprise’s website.


UpdateEnterpriseRepositoryProjectsSettingInput

Autogenerated input type of UpdateEnterpriseRepositoryProjectsSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the repository projects setting.

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the repository projects setting on the enterprise.


UpdateEnterpriseTeamDiscussionsSettingInput

Autogenerated input type of UpdateEnterpriseTeamDiscussionsSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

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

settingValue (EnterpriseEnabledDisabledSettingValue!)

The value for the team discussions setting on the enterprise.


UpdateEnterpriseTwoFactorAuthenticationRequiredSettingInput

Autogenerated input type of UpdateEnterpriseTwoFactorAuthenticationRequiredSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

enterpriseId (ID!)

The ID of the enterprise on which to set the two factor authentication required setting.

settingValue (EnterpriseEnabledSettingValue!)

The value for the two factor authentication required setting on the enterprise.


UpdateEnvironmentInput

Autogenerated input type of UpdateEnvironment

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

environmentId (ID!)

The node ID of the environment.

reviewers ([ID!])

The ids of users or teams that can approve deployments to this environment

waitTimer (Int)

The wait timer in minutes.


UpdateIpAllowListEnabledSettingInput

Autogenerated input type of UpdateIpAllowListEnabledSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

ownerId (ID!)

The ID of the owner on which to set the IP allow list enabled setting.

settingValue (IpAllowListEnabledSettingValue!)

The value for the IP allow list enabled setting.


UpdateIpAllowListEntryInput

Autogenerated input type of UpdateIpAllowListEntry

Input fields

Name Description
allowListValue (String!)

An IP address or range of addresses in CIDR notation.

clientMutationId (String)

A unique identifier for the client performing the mutation.

ipAllowListEntryId (ID!)

The ID of the IP allow list entry to update.

isActive (Boolean!)

Whether the IP allow list entry is active when an IP allow list is enabled.

name (String)

An optional name for the IP allow list entry.


UpdateIpAllowListForInstalledAppsEnabledSettingInput

Autogenerated input type of UpdateIpAllowListForInstalledAppsEnabledSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

ownerId (ID!)

The ID of the owner.

settingValue (IpAllowListForInstalledAppsEnabledSettingValue!)

The value for the IP allow list configuration for installed GitHub Apps setting.


UpdateIssueCommentInput

Autogenerated input type of UpdateIssueComment

Input fields

Name Description
body (String!)

The updated text of the comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the IssueComment to modify.


UpdateIssueInput

Autogenerated input type of UpdateIssue

Input fields

Name Description
assigneeIds ([ID!])

An array of Node IDs of users for this issue.

body (String)

The body for the issue description.

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the Issue to modify.

labelIds ([ID!])

An array of Node IDs of labels for this issue.

milestoneId (ID)

The Node ID of the milestone for this issue.

projectIds ([ID!])

An array of Node IDs for projects associated with this issue.

state (IssueState)

The desired issue state.

title (String)

The title for the issue.


UpdateLabelInput

Autogenerated input type of UpdateLabel

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

color (String)

A 6 character hex code, without the leading #, identifying the updated color of the label.

description (String)

A brief description of the label, such as its purpose.

id (ID!)

The Node ID of the label to be updated.

name (String)

The updated name of the label.


UpdateNotificationRestrictionSettingInput

Autogenerated input type of UpdateNotificationRestrictionSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

ownerId (ID!)

The ID of the owner on which to set the restrict notifications setting.

settingValue (NotificationRestrictionSettingValue!)

The value for the restrict notifications setting.


UpdateOrganizationAllowPrivateRepositoryForkingSettingInput

Autogenerated input type of UpdateOrganizationAllowPrivateRepositoryForkingSetting

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

forkingEnabled (Boolean!)

Enable forking of private repositories in the organization?

organizationId (ID!)

The ID of the organization on which to set the allow private repository forking setting.


UpdateProjectCardInput

Autogenerated input type of UpdateProjectCard

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

isArchived (Boolean)

Whether or not the ProjectCard should be archived

note (String)

The note of ProjectCard.

projectCardId (ID!)

The ProjectCard ID to update.


UpdateProjectColumnInput

Autogenerated input type of UpdateProjectColumn

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String!)

The name of project column.

projectColumnId (ID!)

The ProjectColumn ID to update.


UpdateProjectInput

Autogenerated input type of UpdateProject

Input fields

Name Description
body (String)

The description of project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

name (String)

The name of project.

projectId (ID!)

The Project ID to update.

public (Boolean)

Whether the project is public or not.

state (ProjectState)

Whether the project is open or closed.


UpdateProjectNextInput

Autogenerated input type of UpdateProjectNext

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

closed (Boolean)

Set the project to closed or open.

description (String)

Set the readme description of the project.

projectId (ID!)

The ID of the Project to update.

public (Boolean)

Set the project to public or private.

shortDescription (String)

Set the short description of the project.

title (String)

Set the title of the project.


UpdateProjectNextItemFieldInput

Autogenerated input type of UpdateProjectNextItemField

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

fieldId (ID!)

The id of the field to be updated. Only supports custom fields and status for now.

itemId (ID!)

The id of the item to be updated.

projectId (ID!)

The ID of the Project.

value (String!)

The value which will be set on the field.


UpdatePullRequestBranchInput

Autogenerated input type of UpdatePullRequestBranch

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

expectedHeadOid (GitObjectID)

The head ref oid for the upstream branch.

pullRequestId (ID!)

The Node ID of the pull request.


UpdatePullRequestInput

Autogenerated input type of UpdatePullRequest

Input fields

Name Description
assigneeIds ([ID!])

An array of Node IDs of users for this pull request.

baseRefName (String)

The name of the branch you want your changes pulled into. This should be an existing branch on the current repository.

body (String)

The contents of the pull request.

clientMutationId (String)

A unique identifier for the client performing the mutation.

labelIds ([ID!])

An array of Node IDs of labels for this pull request.

maintainerCanModify (Boolean)

Indicates whether maintainers can modify the pull request.

milestoneId (ID)

The Node ID of the milestone for this pull request.

projectIds ([ID!])

An array of Node IDs for projects associated with this pull request.

pullRequestId (ID!)

The Node ID of the pull request.

state (PullRequestUpdateState)

The target state of the pull request.

title (String)

The title of the pull request.


UpdatePullRequestReviewCommentInput

Autogenerated input type of UpdatePullRequestReviewComment

Input fields

Name Description
body (String!)

The text of the comment.

clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestReviewCommentId (ID!)

The Node ID of the comment to modify.


UpdatePullRequestReviewInput

Autogenerated input type of UpdatePullRequestReview

Input fields

Name Description
body (String!)

The contents of the pull request review body.

clientMutationId (String)

A unique identifier for the client performing the mutation.

pullRequestReviewId (ID!)

The Node ID of the pull request review to modify.


UpdateRefInput

Autogenerated input type of UpdateRef

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

force (Boolean)

Permit updates of branch Refs that are not fast-forwards?

oid (GitObjectID!)

The GitObjectID that the Ref shall be updated to target.

refId (ID!)

The Node ID of the Ref to be updated.


UpdateRefsInput

Autogenerated input type of UpdateRefs

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

refUpdates ([RefUpdate!]!)

A list of ref updates.

repositoryId (ID!)

The Node ID of the repository.


UpdateRepositoryInput

Autogenerated input type of UpdateRepository

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

description (String)

A new description for the repository. Pass an empty string to erase the existing description.

hasIssuesEnabled (Boolean)

Indicates if the repository should have the issues feature enabled.

hasProjectsEnabled (Boolean)

Indicates if the repository should have the project boards feature enabled.

hasWikiEnabled (Boolean)

Indicates if the repository should have the wiki feature enabled.

homepageUrl (URI)

The URL for a web page about this repository. Pass an empty string to erase the existing URL.

name (String)

The new name of the repository.

repositoryId (ID!)

The ID of the repository to update.

template (Boolean)

Whether this repository should be marked as a template such that anyone who can access it can create new repositories with the same files and directory structure.


UpdateSponsorshipPreferencesInput

Autogenerated input type of UpdateSponsorshipPreferences

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

privacyLevel (SponsorshipPrivacy)

Specify whether others should be able to see that the sponsor is sponsoring the sponsorable. Public visibility still does not reveal which tier is used.

receiveEmails (Boolean)

Whether the sponsor should receive email updates from the sponsorable.

sponsorId (ID)

The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given.

sponsorLogin (String)

The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given.

sponsorableId (ID)

The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given.

sponsorableLogin (String)

The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given.


UpdateSubscriptionInput

Autogenerated input type of UpdateSubscription

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

state (SubscriptionState!)

The new state of the subscription.

subscribableId (ID!)

The Node ID of the subscribable object to modify.


UpdateTeamDiscussionCommentInput

Autogenerated input type of UpdateTeamDiscussionComment

Input fields

Name Description
body (String!)

The updated text of the comment.

bodyVersion (String)

The current version of the body content.

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the comment to modify.


UpdateTeamDiscussionInput

Autogenerated input type of UpdateTeamDiscussion

Input fields

Name Description
body (String)

The updated text of the discussion.

bodyVersion (String)

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

clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The Node ID of the discussion to modify.

pinned (Boolean)

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

title (String)

The updated title of the discussion.


UpdateTeamReviewAssignmentInput

Autogenerated input type of UpdateTeamReviewAssignment

Input fields

Name Description
algorithm (TeamReviewAssignmentAlgorithm)

The algorithm to use for review assignment

clientMutationId (String)

A unique identifier for the client performing the mutation.

enabled (Boolean!)

Turn on or off review assignment

excludedTeamMemberIds ([ID!])

An array of team member IDs to exclude

id (ID!)

The Node ID of the team to update review assignments of

notifyTeam (Boolean)

Notify the entire team of the PR if it is delegated

teamMemberCount (Int)

The number of team members to assign


UpdateTopicsInput

Autogenerated input type of UpdateTopics

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

repositoryId (ID!)

The Node ID of the repository.

topicNames ([String!]!)

An array of topic names.


UserStatusOrder

Ordering options for user status connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (UserStatusOrderField!)

The field to order user statuses by.


VerifiableDomainOrder

Ordering options for verifiable domain connections.

Input fields

Name Description
direction (OrderDirection!)

The ordering direction.

field (VerifiableDomainOrderField!)

The field to order verifiable domains by.


VerifyVerifiableDomainInput

Autogenerated input type of VerifyVerifiableDomain

Input fields

Name Description
clientMutationId (String)

A unique identifier for the client performing the mutation.

id (ID!)

The ID of the verifiable domain to verify.