About input objects
Input objects can be described as "composable objects" because they include a set of input fields that define the object.
For example, CommitAuthor
takes a field called emails
. Providing a value for emails
transforms CommitAuthor
into a list of User
objects containing that email address. Note that objects may have input objects, whereas mutations require input objects.
For more information, see Forming calls with GraphQL.
AbortQueuedMigrationsInput
Autogenerated input type of AbortQueuedMigrations.
AbortRepositoryMigrationInput
Autogenerated input type of AbortRepositoryMigration.
AcceptEnterpriseAdministratorInvitationInput
Autogenerated input type of AcceptEnterpriseAdministratorInvitation.
AcceptEnterpriseMemberInvitationInput
Autogenerated input type of AcceptEnterpriseMemberInvitation.
AcceptTopicSuggestionInput
Autogenerated input type of AcceptTopicSuggestion.
Input fields for AcceptTopicSuggestionInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The name of the suggested topic. Upcoming Change on 2024-04-01 UTC
Description: |
| The Node ID of the repository. Upcoming Change on 2024-04-01 UTC
Description: |
AccessUserNamespaceRepositoryInput
Autogenerated input type of AccessUserNamespaceRepository.
AddAssigneesToAssignableInput
Autogenerated input type of AddAssigneesToAssignable.
AddBlockedByInput
Autogenerated input type of AddBlockedBy.
AddCommentInput
Autogenerated input type of AddComment.
AddDiscussionCommentInput
Autogenerated input type of AddDiscussionComment.
Input fields for AddDiscussionCommentInput
Name | Description |
---|---|
| The contents of the comment. |
| A unique identifier for the client performing the mutation. |
| The Node ID of the discussion to comment on. |
| The Node ID of the discussion comment within this discussion to reply to. |
AddDiscussionPollVoteInput
Autogenerated input type of AddDiscussionPollVote.
AddEnterpriseOrganizationMemberInput
Autogenerated input type of AddEnterpriseOrganizationMember.
Input fields for AddEnterpriseOrganizationMemberInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The ID of the enterprise which owns the organization. |
| The ID of the organization the users will be added to. |
| The role to assign the users in the organization. |
| The IDs of the enterprise members to add. |
AddEnterpriseSupportEntitlementInput
Autogenerated input type of AddEnterpriseSupportEntitlement.
Input fields for AddEnterpriseSupportEntitlementInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The ID of the Enterprise which the admin belongs to. |
| The login of a member who will receive the support entitlement. |
AddLabelsToLabelableInput
Autogenerated input type of AddLabelsToLabelable.
AddProjectCardInput
Autogenerated input type of AddProjectCard.
Input fields for AddProjectCardInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The content of the card. Must be a member of the ProjectCardItem union. |
| The note on the card. |
| The Node ID of the ProjectColumn. |
AddProjectColumnInput
Autogenerated input type of AddProjectColumn.
AddProjectV2DraftIssueInput
Autogenerated input type of AddProjectV2DraftIssue.
Input fields for AddProjectV2DraftIssueInput
Name | Description |
---|---|
| The IDs of the assignees of the draft issue. |
| The body of the draft issue. |
| A unique identifier for the client performing the mutation. |
| The ID of the Project to add the draft issue to. |
| The title of the draft issue. A project item can also be created by providing the URL of an Issue or Pull Request if you have access. |
AddProjectV2ItemByIdInput
Autogenerated input type of AddProjectV2ItemById.
AddPullRequestReviewCommentInput
Autogenerated input type of AddPullRequestReviewComment.
Input fields for AddPullRequestReviewCommentInput
Name | Description |
---|---|
| The text of the comment. This field is required Upcoming Change on 2023-10-01 UTC
Description: |
| A unique identifier for the client performing the mutation. |
| The SHA of the commit to comment on. Upcoming Change on 2023-10-01 UTC
Description: |
| The comment id to reply to. Upcoming Change on 2023-10-01 UTC
Description: |
| The relative path of the file to comment on. Upcoming Change on 2023-10-01 UTC
Description: |
| The line index in the diff to comment on. Upcoming Change on 2023-10-01 UTC
Description: |
| The node ID of the pull request reviewing Upcoming Change on 2023-10-01 UTC
Description: |
| The Node ID of the review to modify. Upcoming Change on 2023-10-01 UTC
Description: |
AddPullRequestReviewInput
Autogenerated input type of AddPullRequestReview.
Input fields for AddPullRequestReviewInput
Name | Description |
---|---|
| The contents of the review body comment. |
| A unique identifier for the client performing the mutation. |
| The review line comments. Upcoming Change on 2023-10-01 UTC
Description: |
| The commit OID the review pertains to. |
| The event to perform on the pull request review. |
| The Node ID of the pull request to modify. |
| The review line comment threads. |
AddPullRequestReviewThreadInput
Autogenerated input type of AddPullRequestReviewThread.
Input fields for AddPullRequestReviewThreadInput
Name | Description |
---|---|
| Body of the thread's first comment. |
| A unique identifier for the client performing the mutation. |
| The line of the blob to which the thread refers, required for line-level threads. The end of the line range for multi-line comments. |
| Path to the file being commented on. |
| The node ID of the pull request reviewing. |
| The Node ID of the review to modify. |
| 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. |
| The first line of the range to which the comment refers. |
| The side of the diff on which the start line resides. |
| The level at which the comments in the corresponding thread are targeted, can be a diff line or a file. |
AddPullRequestReviewThreadReplyInput
Autogenerated input type of AddPullRequestReviewThreadReply.
Input fields for AddPullRequestReviewThreadReplyInput
Name | Description |
---|---|
| The text of the reply. |
| A unique identifier for the client performing the mutation. |
| The Node ID of the pending review to which the reply will belong. |
| The Node ID of the thread to which this reply is being written. |
AddReactionInput
Autogenerated input type of AddReaction.
Input fields for AddReactionInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The name of the emoji to react with. |
| The Node ID of the subject to modify. |
AddStarInput
Autogenerated input type of AddStar.
AddSubIssueInput
Autogenerated input type of AddSubIssue.
Input fields for AddSubIssueInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The id of the issue. |
| Option to replace parent issue if one already exists. |
| The id of the sub-issue. |
| The url of the sub-issue. |
AddUpvoteInput
Autogenerated input type of AddUpvote.
AddVerifiableDomainInput
Autogenerated input type of AddVerifiableDomain.
ApproveDeploymentsInput
Autogenerated input type of ApproveDeployments.
Input fields for ApproveDeploymentsInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| Optional comment for approving deployments. |
| The ids of environments to reject deployments. |
| The node ID of the workflow run containing the pending deployments. |
ApproveVerifiableDomainInput
Autogenerated input type of ApproveVerifiableDomain.
ArchiveProjectV2ItemInput
Autogenerated input type of ArchiveProjectV2Item.
ArchiveRepositoryInput
Autogenerated input type of ArchiveRepository.
AuditLogOrder
Ordering options for Audit Log connections.
Input fields for AuditLogOrder
Name | Description |
---|---|
| The ordering direction. |
| The field to order Audit Logs by. |
BranchNamePatternParametersInput
Parameters to be used for the branch_name_pattern rule.
BulkSponsorship
Information about a sponsorship to make for a user or organization with a GitHub Sponsors profile, as part of sponsoring many users or organizations at once.
Input fields for BulkSponsorship
Name | Description |
---|---|
| The amount to pay to the sponsorable in US dollars. Valid values: 1-12000. |
| The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given. |
| The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given. |
CancelEnterpriseAdminInvitationInput
Autogenerated input type of CancelEnterpriseAdminInvitation.
CancelEnterpriseMemberInvitationInput
Autogenerated input type of CancelEnterpriseMemberInvitation.
CancelSponsorshipInput
Autogenerated input type of CancelSponsorship.
Input fields for CancelSponsorshipInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given. |
| The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given. |
| The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given. |
| 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 for ChangeUserStatusInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The emoji to represent your status. Can either be a native Unicode emoji or an emoji name with colons, e.g., 😀. |
| If set, the user status will not be shown after this date. |
| Whether this status should indicate you are not fully available on GitHub, e.g., you are away. |
| A short description of your current status. |
| 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 for CheckAnnotationData
Name | Description |
---|---|
| Represents an annotation's information level. |
| The location of the annotation. |
| A short description of the feedback for these lines of code. |
| The path of the file to add an annotation to. |
| Details about this annotation. |
| The title that represents the annotation. |
CheckAnnotationRange
Information from a check run analysis to specific lines of code.
CheckRunAction
Possible further actions the integrator can perform.
CheckRunFilter
The filters that are available when fetching check runs.
Input fields for CheckRunFilter
Name | Description |
---|---|
| Filters the check runs created by this application ID. |
| Filters the check runs by this name. |
| Filters the check runs by this type. |
| Filters the check runs by these conclusions. |
| Filters the check runs by this status. Superceded by statuses. |
| Filters the check runs by this status. Overrides status. |
CheckRunOutput
Descriptive details about the check run.
Input fields for CheckRunOutput
Name | Description |
---|---|
| The annotations that are made as part of the check run. |
| Images attached to the check run output displayed in the GitHub pull request UI. |
| The summary of the check run (supports Commonmark). |
| The details of the check run (supports Commonmark). |
| A title to provide for this check run. |
CheckRunOutputImage
Images attached to the check run output displayed in the GitHub pull request UI.
CheckSuiteAutoTriggerPreference
The auto-trigger preferences that are available for check suites.
CheckSuiteFilter
The filters that are available when fetching check suites.
ClearLabelsFromLabelableInput
Autogenerated input type of ClearLabelsFromLabelable.
ClearProjectV2ItemFieldValueInput
Autogenerated input type of ClearProjectV2ItemFieldValue.
CloneProjectInput
Autogenerated input type of CloneProject.
Input fields for CloneProjectInput
Name | Description |
---|---|
| The description of the project. |
| A unique identifier for the client performing the mutation. |
| Whether or not to clone the source project's workflows. |
| The name of the project. |
| The visibility of the project, defaults to false (private). |
| The source project to clone. |
| The owner ID to create the project under. |
CloneTemplateRepositoryInput
Autogenerated input type of CloneTemplateRepository.
Input fields for CloneTemplateRepositoryInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| A short description of the new repository. |
| Whether to copy all branches from the template to the new repository. Defaults to copying only the default branch of the template. |
| The name of the new repository. |
| The ID of the owner for the new repository. |
| The Node ID of the template repository. |
| Indicates the repository's visibility level. |
CloseDiscussionInput
Autogenerated input type of CloseDiscussion.
Input fields for CloseDiscussionInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| ID of the discussion to be closed. |
| The reason why the discussion is being closed. |
CloseIssueInput
Autogenerated input type of CloseIssue.
Input fields for CloseIssueInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| ID of the issue that this is a duplicate of. |
| ID of the issue to be closed. |
| The reason the issue is to be closed. |
ClosePullRequestInput
Autogenerated input type of ClosePullRequest.
CodeScanningParametersInput
Choose which tools must provide code scanning results before the reference is updated. When configured, code scanning must be enabled and have results for both the commit and the reference being updated.
Input fields for CodeScanningParametersInput
Name | Description |
---|---|
| Tools that must provide code scanning results for this rule to pass. |
CodeScanningToolInput
A tool that must provide code scanning results for this rule to pass.
Input fields for CodeScanningToolInput
Name | Description |
---|---|
| The severity level at which code scanning results that raise alerts block a reference update. For more information on alert severity levels, see "About code scanning alerts.". |
| The severity level at which code scanning results that raise security alerts block a reference update. For more information on security severity levels, see "About code scanning alerts.". |
| The name of a code scanning tool. |
CommitAuthor
Specifies an author for filtering Git commits.
Input fields for CommitAuthor
Name | Description |
---|---|
| Email addresses to filter by. Commits authored by any of the specified email addresses will be returned. |
| 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. |
CommitAuthorEmailPatternParametersInput
Parameters to be used for the commit_author_email_pattern rule.
CommitContributionOrder
Ordering options for commit contribution connections.
Input fields for CommitContributionOrder
Name | Description |
---|---|
| The ordering direction. |
| The field by which to order commit contributions. |
CommitMessage
A message to include with a new commit.
CommitMessagePatternParametersInput
Parameters to be used for the commit_message_pattern rule.
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
repositoryNameWithOwner
and branchName
.
Examples
Specify a branch using a global node ID:
{ "id": "MDM6UmVmMTpyZWZzL2hlYWRzL21haW4=" }
Specify a branch using repositoryNameWithOwner
and branchName
:
{
"repositoryNameWithOwner": "github/graphql-client",
"branchName": "main"
}.
CommitterEmailPatternParametersInput
Parameters to be used for the committer_email_pattern rule.
ContributionOrder
Ordering options for contribution connections.
Input fields for ContributionOrder
Name | Description |
---|---|
| The ordering direction. |
ConvertProjectCardNoteToIssueInput
Autogenerated input type of ConvertProjectCardNoteToIssue.
Input fields for ConvertProjectCardNoteToIssueInput
Name | Description |
---|---|
| The body of the newly created issue. |
| A unique identifier for the client performing the mutation. |
| The ProjectCard ID to convert. |
| The ID of the repository to create the issue in. |
| The title of the newly created issue. Defaults to the card's note text. |
ConvertProjectV2DraftIssueItemToIssueInput
Autogenerated input type of ConvertProjectV2DraftIssueItemToIssue.
ConvertPullRequestToDraftInput
Autogenerated input type of ConvertPullRequestToDraft.
CopyProjectV2Input
Autogenerated input type of CopyProjectV2.
Input fields for CopyProjectV2Input
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| Include draft issues in the new project. |
| The owner ID of the new project. |
| The ID of the source Project to copy. |
| The title of the project. |
CreateAttributionInvitationInput
Autogenerated input type of CreateAttributionInvitation.
Input fields for CreateAttributionInvitationInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The Node ID of the owner scoping the reattributable data. |
| The Node ID of the account owning the data to reattribute. |
| The Node ID of the account which may claim the data. |
CreateBranchProtectionRuleInput
Autogenerated input type of CreateBranchProtectionRule.
Input fields for CreateBranchProtectionRuleInput
Name | Description |
---|---|
| Can this branch be deleted. |
| Are force pushes allowed on this branch. |
| Is branch creation a protected operation. |
| A list of User, Team, or App IDs allowed to bypass force push targeting matching branches. |
| A list of User, Team, or App IDs allowed to bypass pull requests targeting matching branches. |
| A unique identifier for the client performing the mutation. |
| Will new commits pushed to matching branches dismiss pull request review approvals. |
| Can admins override branch protection. |
| Whether users can pull changes from upstream when the branch is locked. Set to
|
| Whether to set the branch as read-only. If this is true, users will not be able to push to the branch. |
| The glob-like pattern used to determine matching branches. |
| A list of User, Team, or App IDs allowed to push to matching branches. |
| The global relay id of the repository in which a new branch protection rule should be created in. |
| Whether the most recent push must be approved by someone other than the person who pushed it. |
| Number of approving reviews required to update matching branches. |
| The list of required deployment environments. |
| List of required status check contexts that must pass for commits to be accepted to matching branches. |
| The list of required status checks. |
| Are approving reviews required to update matching branches. |
| Are reviews from code owners required to update matching branches. |
| Are commits required to be signed. |
| Are conversations required to be resolved before merging. |
| Are successful deployments required before merging. |
| Are merge commits prohibited from being pushed to this branch. |
| Are status checks required to update matching branches. |
| Are branches required to be up to date before merging. |
| Is pushing to matching branches restricted. |
| Is dismissal of pull request reviews restricted. |
| A list of User, Team, or App IDs allowed to dismiss reviews on pull requests targeting matching branches. |
CreateCheckRunInput
Autogenerated input type of CreateCheckRun.
Input fields for CreateCheckRunInput
Name | Description |
---|---|
| Possible further actions the integrator can perform, which a user may trigger. |
| A unique identifier for the client performing the mutation. |
| The time that the check run finished. |
| The final conclusion of the check. |
| The URL of the integrator's site that has the full details of the check. |
| A reference for the run on the integrator's system. |
| The SHA of the head commit. |
| The name of the check. |
| Descriptive details about the run. |
| The node ID of the repository. |
| The time that the check run began. |
| The current status. |
CreateCheckSuiteInput
Autogenerated input type of CreateCheckSuite.
Input fields for CreateCheckSuiteInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The SHA of the head commit. |
| The Node ID of the repository. |
CreateCommitOnBranchInput
Autogenerated input type of CreateCommitOnBranch.
Input fields for CreateCommitOnBranchInput
Name | Description |
---|---|
| The Ref to be updated. Must be a branch. |
| A unique identifier for the client performing the mutation. |
| The git commit oid expected at the head of the branch prior to the commit. |
| A description of changes to files in this commit. |
| The commit message the be included with the commit. |
CreateDeploymentInput
Autogenerated input type of CreateDeployment.
Input fields for CreateDeploymentInput
Name | Description |
---|---|
| Attempt to automatically merge the default branch into the requested ref, defaults to true. |
| A unique identifier for the client performing the mutation. |
| Short description of the deployment. |
| Name for the target deployment environment. |
| JSON payload with extra information about the deployment. |
| The node ID of the ref to be deployed. |
| The node ID of the repository. |
| The status contexts to verify against commit status checks. To bypass required contexts, pass an empty array. Defaults to all unique contexts. |
| Specifies a task to execute. |
CreateDeploymentStatusInput
Autogenerated input type of CreateDeploymentStatus.
Input fields for CreateDeploymentStatusInput
Name | Description |
---|---|
| 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. |
| A unique identifier for the client performing the mutation. |
| The node ID of the deployment. |
| A short description of the status. Maximum length of 140 characters. |
| If provided, updates the environment of the deploy. Otherwise, does not modify the environment. |
| Sets the URL for accessing your environment. |
| 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. |
| The state of the deployment. |
CreateDiscussionInput
Autogenerated input type of CreateDiscussion.
Input fields for CreateDiscussionInput
Name | Description |
---|---|
| The body of the discussion. |
| The id of the discussion category to associate with this discussion. |
| A unique identifier for the client performing the mutation. |
| The id of the repository on which to create the discussion. |
| The title of the discussion. |
CreateEnterpriseOrganizationInput
Autogenerated input type of CreateEnterpriseOrganization.
Input fields for CreateEnterpriseOrganizationInput
Name | Description |
---|---|
| The logins for the administrators of the new organization. |
| The email used for sending billing receipts. |
| A unique identifier for the client performing the mutation. |
| The ID of the enterprise owning the new organization. |
| The login of the new organization. |
| The profile name of the new organization. |
CreateEnvironmentInput
Autogenerated input type of CreateEnvironment.
CreateIpAllowListEntryInput
Autogenerated input type of CreateIpAllowListEntry.
Input fields for CreateIpAllowListEntryInput
Name | Description |
---|---|
| An IP address or range of addresses in CIDR notation. |
| A unique identifier for the client performing the mutation. |
| Whether the IP allow list entry is active when an IP allow list is enabled. |
| An optional name for the IP allow list entry. |
| The ID of the owner for which to create the new IP allow list entry. |
CreateIssueInput
Autogenerated input type of CreateIssue.
Input fields for CreateIssueInput
Name | Description |
---|---|
| The Node ID of assignees for this issue. |
| The body for the issue description. |
| A unique identifier for the client performing the mutation. |
| The name of an issue template in the repository, assigns labels and assignees from the template to the issue. |
| The Node ID of the issue type for this issue. |
| An array of Node IDs of labels for this issue. |
| The Node ID of the milestone for this issue. |
| The Node ID of the parent issue to add this new issue to. |
| An array of Node IDs for projects associated with this issue. |
| The Node ID of the repository. |
| The title for the issue. |
CreateIssueTypeInput
Autogenerated input type of CreateIssueType.
Input fields for CreateIssueTypeInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| Color for the issue type. |
| Description of the new issue type. |
| Whether or not the issue type is enabled on the org level. |
| Name of the new issue type. |
| The ID for the organization on which the issue type is created. |
CreateLabelInput
Autogenerated input type of CreateLabel.
Input fields for CreateLabelInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| A 6 character hex code, without the leading #, identifying the color of the label. |
| A brief description of the label, such as its purpose. |
| The name of the label. |
| The Node ID of the repository. |
CreateLinkedBranchInput
Autogenerated input type of CreateLinkedBranch.
Input fields for CreateLinkedBranchInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| ID of the issue to link to. |
| The name of the new branch. Defaults to issue number and title. |
| The commit SHA to base the new branch on. |
| ID of the repository to create the branch in. Defaults to the issue repository. |
CreateMigrationSourceInput
Autogenerated input type of CreateMigrationSource.
Input fields for CreateMigrationSourceInput
Name | Description |
---|---|
| The migration source access token. |
| A unique identifier for the client performing the mutation. |
| The GitHub personal access token of the user importing to the target repository. |
| The migration source name. |
| The ID of the organization that will own the migration source. |
| The migration source type. |
| The migration source URL, for example |
CreateProjectInput
Autogenerated input type of CreateProject.
Input fields for CreateProjectInput
Name | Description |
---|---|
| The description of project. |
| A unique identifier for the client performing the mutation. |
| The name of project. |
| The owner ID to create the project under. |
| A list of repository IDs to create as linked repositories for the project. |
| The name of the GitHub-provided template. |
CreateProjectV2FieldInput
Autogenerated input type of CreateProjectV2Field.
Input fields for CreateProjectV2FieldInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The data type of the field. |
| Configuration for an iteration field. |
| The name of the field. |
| The ID of the Project to create the field in. |
| Options for a single select field. At least one value is required if data_type is SINGLE_SELECT. |
CreateProjectV2Input
Autogenerated input type of CreateProjectV2.
Input fields for CreateProjectV2Input
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The owner ID to create the project under. |
| The repository to link the project to. |
| The team to link the project to. The team will be granted read permissions. |
| The title of the project. |
CreateProjectV2StatusUpdateInput
Autogenerated input type of CreateProjectV2StatusUpdate.
Input fields for CreateProjectV2StatusUpdateInput
Name | Description |
---|---|
| The body of the status update. |
| A unique identifier for the client performing the mutation. |
| The ID of the Project to create the status update in. |
| The start date of the status update. |
| The status of the status update. |
| The target date of the status update. |
CreatePullRequestInput
Autogenerated input type of CreatePullRequest.
Input fields for CreatePullRequestInput
Name | Description |
---|---|
| 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. |
| The contents of the pull request. |
| A unique identifier for the client performing the mutation. |
| Indicates whether this pull request should be a draft. |
| The name of the branch where your changes are implemented. For cross-repository pull requests
in the same network, namespace |
| The Node ID of the head repository. |
| Indicates whether maintainers can modify the pull request. |
| The Node ID of the repository. |
| The title of the pull request. |
CreateRefInput
Autogenerated input type of CreateRef.
Input fields for CreateRefInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The fully qualified name of the new Ref (ie: |
| The GitObjectID that the new Ref shall target. Must point to a commit. |
| The Node ID of the Repository to create the Ref in. |
CreateRepositoryInput
Autogenerated input type of CreateRepository.
Input fields for CreateRepositoryInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| A short description of the new repository. |
| Indicates if the repository should have the issues feature enabled. |
| Indicates if the repository should have the wiki feature enabled. |
| The URL for a web page about this repository. |
| The name of the new repository. |
| The ID of the owner for the new repository. |
| When an organization is specified as the owner, this ID identifies the team that should be granted access to the new repository. |
| 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. |
| Indicates the repository's visibility level. |
CreateRepositoryRulesetInput
Autogenerated input type of CreateRepositoryRuleset.
Input fields for CreateRepositoryRulesetInput
Name | Description |
---|---|
| A list of actors that are allowed to bypass rules in this ruleset. |
| A unique identifier for the client performing the mutation. |
| The set of conditions for this ruleset. |
| The enforcement level for this ruleset. |
| The name of the ruleset. |
| The list of rules for this ruleset. |
| The global relay id of the source in which a new ruleset should be created in. |
| The target of the ruleset. |
CreateSponsorsListingInput
Autogenerated input type of CreateSponsorsListing.
Input fields for CreateSponsorsListingInput
Name | Description |
---|---|
| The country or region where the sponsorable's bank account is located. Required if fiscalHostLogin is not specified, ignored when fiscalHostLogin is specified. |
| A unique identifier for the client performing the mutation. |
| The email address we should use to contact you about the GitHub Sponsors profile being created. This will not be shared publicly. Must be a verified email address already on your GitHub account. Only relevant when the sponsorable is yourself. Defaults to your primary email address on file if omitted. |
| The username of the supported fiscal host's GitHub organization, if you want
to receive sponsorship payouts through a fiscal host rather than directly to a
bank account. For example, |
| The URL for your profile page on the fiscal host's website, e.g., https://opencollective.com/babel or https://numfocus.org/project/bokeh. Required if fiscalHostLogin is specified. |
| Provide an introduction to serve as the main focus that appears on your GitHub Sponsors profile. It's a great opportunity to help potential sponsors learn more about you, your work, and why their sponsorship is important to you. GitHub-flavored Markdown is supported. |
| The country or region where the sponsorable resides. This is for tax purposes. Required if the sponsorable is yourself, ignored when sponsorableLogin specifies an organization. |
| The username of the organization to create a GitHub Sponsors profile for, if desired. Defaults to creating a GitHub Sponsors profile for the authenticated user if omitted. |
CreateSponsorsTierInput
Autogenerated input type of CreateSponsorsTier.
Input fields for CreateSponsorsTierInput
Name | Description |
---|---|
| The value of the new tier in US dollars. Valid values: 1-12000. |
| A unique identifier for the client performing the mutation. |
| A description of what this tier is, what perks sponsors might receive, what a sponsorship at this tier means for you, etc. |
| Whether sponsorships using this tier should happen monthly/yearly or just once. |
| Whether to make the tier available immediately for sponsors to choose. Defaults to creating a draft tier that will not be publicly visible. |
| Optional ID of the private repository that sponsors at this tier should gain read-only access to. Must be owned by an organization. |
| Optional name of the private repository that sponsors at this tier should gain read-only access to. Must be owned by an organization. Necessary if repositoryOwnerLogin is given. Will be ignored if repositoryId is given. |
| Optional login of the organization owner of the private repository that sponsors at this tier should gain read-only access to. Necessary if repositoryName is given. Will be ignored if repositoryId is given. |
| The ID of the user or organization who owns the GitHub Sponsors profile. Defaults to the current user if omitted and sponsorableLogin is not given. |
| The username of the user or organization who owns the GitHub Sponsors profile. Defaults to the current user if omitted and sponsorableId is not given. |
| Optional message new sponsors at this tier will receive. |
CreateSponsorshipInput
Autogenerated input type of CreateSponsorship.
Input fields for CreateSponsorshipInput
Name | Description |
---|---|
| The amount to pay to the sponsorable in US dollars. Required if a tierId is not specified. Valid values: 1-12000. |
| A unique identifier for the client performing the mutation. |
| Whether the sponsorship should happen monthly/yearly or just this one time. Required if a tierId is not specified. |
| 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. |
| Whether the sponsor should receive email updates from the sponsorable. |
| The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given. |
| The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given. |
| The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given. |
| The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given. |
| The ID of one of sponsorable's existing tiers to sponsor at. Required if amount is not specified. |
CreateSponsorshipsInput
Autogenerated input type of CreateSponsorships.
Input fields for CreateSponsorshipsInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| Specify whether others should be able to see that the sponsor is sponsoring the sponsorables. Public visibility still does not reveal the dollar value of the sponsorship. |
| Whether the sponsor should receive email updates from the sponsorables. |
| Whether the sponsorships created should continue each billing cycle for the sponsor (monthly or annually), versus lasting only a single month. Defaults to one-time sponsorships. |
| The username of the user or organization who is acting as the sponsor, paying for the sponsorships. |
| The list of maintainers to sponsor and for how much apiece. |
CreateTeamDiscussionCommentInput
Autogenerated input type of CreateTeamDiscussionComment.
Input fields for CreateTeamDiscussionCommentInput
Name | Description |
---|---|
| The content of the comment. This field is required. Upcoming Change on 2024-07-01 UTC
Description: |
| A unique identifier for the client performing the mutation. |
| The ID of the discussion to which the comment belongs. This field is required. Upcoming Change on 2024-07-01 UTC
Description: |
CreateTeamDiscussionInput
Autogenerated input type of CreateTeamDiscussion.
Input fields for CreateTeamDiscussionInput
Name | Description |
---|---|
| The content of the discussion. This field is required. Upcoming Change on 2024-07-01 UTC
Description: |
| A unique identifier for the client performing the mutation. |
| If true, restricts the visibility of this discussion to team members and organization owners. If false or not specified, allows any organization member to view this discussion. Upcoming Change on 2024-07-01 UTC
Description: |
| The ID of the team to which the discussion belongs. This field is required. Upcoming Change on 2024-07-01 UTC
Description: |
| The title of the discussion. This field is required. Upcoming Change on 2024-07-01 UTC
Description: |
CreateUserListInput
Autogenerated input type of CreateUserList.
DeclineTopicSuggestionInput
Autogenerated input type of DeclineTopicSuggestion.
Input fields for DeclineTopicSuggestionInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The name of the suggested topic. Upcoming Change on 2024-04-01 UTC
Description: |
| The reason why the suggested topic is declined. Upcoming Change on 2024-04-01 UTC
Description: |
| The Node ID of the repository. Upcoming Change on 2024-04-01 UTC
Description: |
DeleteBranchProtectionRuleInput
Autogenerated input type of DeleteBranchProtectionRule.
DeleteDeploymentInput
Autogenerated input type of DeleteDeployment.
DeleteDiscussionCommentInput
Autogenerated input type of DeleteDiscussionComment.
DeleteDiscussionInput
Autogenerated input type of DeleteDiscussion.
DeleteEnvironmentInput
Autogenerated input type of DeleteEnvironment.
DeleteIpAllowListEntryInput
Autogenerated input type of DeleteIpAllowListEntry.
DeleteIssueCommentInput
Autogenerated input type of DeleteIssueComment.
DeleteIssueInput
Autogenerated input type of DeleteIssue.
DeleteIssueTypeInput
Autogenerated input type of DeleteIssueType.
DeleteLabelInput
Autogenerated input type of DeleteLabel.
DeleteLinkedBranchInput
Autogenerated input type of DeleteLinkedBranch.
DeletePackageVersionInput
Autogenerated input type of DeletePackageVersion.
DeleteProjectCardInput
Autogenerated input type of DeleteProjectCard.
DeleteProjectColumnInput
Autogenerated input type of DeleteProjectColumn.
DeleteProjectInput
Autogenerated input type of DeleteProject.
DeleteProjectV2FieldInput
Autogenerated input type of DeleteProjectV2Field.
DeleteProjectV2Input
Autogenerated input type of DeleteProjectV2.
DeleteProjectV2ItemInput
Autogenerated input type of DeleteProjectV2Item.
DeleteProjectV2StatusUpdateInput
Autogenerated input type of DeleteProjectV2StatusUpdate.
DeleteProjectV2WorkflowInput
Autogenerated input type of DeleteProjectV2Workflow.
DeletePullRequestReviewCommentInput
Autogenerated input type of DeletePullRequestReviewComment.
DeletePullRequestReviewInput
Autogenerated input type of DeletePullRequestReview.
DeleteRefInput
Autogenerated input type of DeleteRef.
DeleteRepositoryRulesetInput
Autogenerated input type of DeleteRepositoryRuleset.
DeleteTeamDiscussionCommentInput
Autogenerated input type of DeleteTeamDiscussionComment.
DeleteTeamDiscussionInput
Autogenerated input type of DeleteTeamDiscussion.
DeleteUserListInput
Autogenerated input type of DeleteUserList.
DeleteVerifiableDomainInput
Autogenerated input type of DeleteVerifiableDomain.
DeploymentOrder
Ordering options for deployment connections.
Input fields for DeploymentOrder
Name | Description |
---|---|
| The ordering direction. |
| The field to order deployments by. |
DequeuePullRequestInput
Autogenerated input type of DequeuePullRequest.
DisablePullRequestAutoMergeInput
Autogenerated input type of DisablePullRequestAutoMerge.
DiscussionOrder
Ways in which lists of discussions can be ordered upon return.
Input fields for DiscussionOrder
Name | Description |
---|---|
| The direction in which to order discussions by the specified field. |
| The field by which to order discussions. |
DiscussionPollOptionOrder
Ordering options for discussion poll option connections.
Input fields for DiscussionPollOptionOrder
Name | Description |
---|---|
| The ordering direction. |
| The field to order poll options by. |
DismissPullRequestReviewInput
Autogenerated input type of DismissPullRequestReview.
DismissRepositoryVulnerabilityAlertInput
Autogenerated input type of DismissRepositoryVulnerabilityAlert.
Input fields for DismissRepositoryVulnerabilityAlertInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The reason the Dependabot alert is being dismissed. |
| The Dependabot alert ID to dismiss. |
DraftPullRequestReviewComment
Specifies a review comment to be left with a Pull Request Review.
DraftPullRequestReviewThread
Specifies a review comment thread to be left with a Pull Request Review.
Input fields for DraftPullRequestReviewThread
Name | Description |
---|---|
| Body of the comment to leave. |
| The line of the blob to which the thread refers. The end of the line range for multi-line comments. Required if not using positioning. |
| Path to the file being commented on. Required if not using positioning. |
| 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. |
| The first line of the range to which the comment refers. |
| The side of the diff on which the start line resides. |
EnablePullRequestAutoMergeInput
Autogenerated input type of EnablePullRequestAutoMerge.
Input fields for EnablePullRequestAutoMergeInput
Name | Description |
---|---|
| The email address to associate with this merge. |
| A unique identifier for the client performing the mutation. |
| Commit body to use for the commit when the PR is mergable; if omitted, a default message will be used. NOTE: when merging with a merge queue any input value for commit message is ignored. |
| Commit headline to use for the commit when the PR is mergable; if omitted, a default message will be used. NOTE: when merging with a merge queue any input value for commit headline is ignored. |
| The expected head OID of the pull request. |
| The merge method to use. If omitted, defaults to |
| ID of the pull request to enable auto-merge on. |
EnqueuePullRequestInput
Autogenerated input type of EnqueuePullRequest.
Input fields for EnqueuePullRequestInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The expected head OID of the pull request. |
| Add the pull request to the front of the queue. |
| The ID of the pull request to enqueue. |
EnterpriseAdministratorInvitationOrder
Ordering options for enterprise administrator invitation connections.
Input fields for EnterpriseAdministratorInvitationOrder
Name | Description |
---|---|
| The ordering direction. |
The field to order enterprise administrator invitations by. |
EnterpriseMemberInvitationOrder
Ordering options for enterprise administrator invitation connections.
Input fields for EnterpriseMemberInvitationOrder
Name | Description |
---|---|
| The ordering direction. |
The field to order enterprise member invitations by. |
EnterpriseMemberOrder
Ordering options for enterprise member connections.
Input fields for EnterpriseMemberOrder
Name | Description |
---|---|
| The ordering direction. |
| The field to order enterprise members by. |
EnterpriseOrder
Ordering options for enterprises.
Input fields for EnterpriseOrder
Name | Description |
---|---|
| The ordering direction. |
| The field to order enterprises by. |
EnterpriseServerInstallationOrder
Ordering options for Enterprise Server installation connections.
Input fields for EnterpriseServerInstallationOrder
Name | Description |
---|---|
| The ordering direction. |
The field to order Enterprise Server installations by. |
EnterpriseServerUserAccountEmailOrder
Ordering options for Enterprise Server user account email connections.
Input fields for EnterpriseServerUserAccountEmailOrder
Name | Description |
---|---|
| The ordering direction. |
The field to order emails by. |
EnterpriseServerUserAccountOrder
Ordering options for Enterprise Server user account connections.
Input fields for EnterpriseServerUserAccountOrder
Name | Description |
---|---|
| The ordering direction. |
The field to order user accounts by. |
EnterpriseServerUserAccountsUploadOrder
Ordering options for Enterprise Server user accounts upload connections.
Input fields for EnterpriseServerUserAccountsUploadOrder
Name | Description |
---|---|
| The ordering direction. |
The field to order user accounts uploads by. |
Environments
Ordering options for environments.
Input fields for Environments
Name | Description |
---|---|
| The direction in which to order environments by the specified field. |
| The field to order environments 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 for FileAddition
Name | Description |
---|---|
| The base64 encoded contents of the file. |
| 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:
-
New file addition: create file
hello world\n
at pathdocs/README.txt
:{ "additions" [ { "path": "docs/README.txt", "contents": base64encode("hello world\n") } ] }
-
Existing file modification: change existing
docs/README.txt
to have new contentnew content here\n
:{ "additions" [ { "path": "docs/README.txt", "contents": base64encode("new content here\n") } ] }
-
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" } ] }
-
File rename with no changes: rename
docs/README.txt
with previous contenthello world\n
to the same content atnewdocs/README.txt
:{ "deletions" [ { "path": "docs/README.txt", } ], "additions" [ { "path": "newdocs/README.txt", "contents": base64encode("hello world\n") } ] }
-
File rename with changes: rename
docs/README.txt
with previous contenthello world\n
to a file at pathnewdocs/README.txt
with contentnew contents\n
:{ "deletions" [ { "path": "docs/README.txt", } ], "additions" [ { "path": "newdocs/README.txt", "contents": base64encode("new contents\n") } ] }.
Input fields for FileChanges
Name | Description |
---|---|
| File to add or change. |
| Files to delete. |
FileDeletion
A command to delete the file at the given path as part of a commit.
Input fields for FileDeletion
Name | Description |
---|---|
| The path to delete. |
FileExtensionRestrictionParametersInput
Prevent commits that include files with specified file extensions from being pushed to the commit graph.
Input fields for FileExtensionRestrictionParametersInput
Name | Description |
---|---|
| The file extensions that are restricted from being pushed to the commit graph. |
FilePathRestrictionParametersInput
Prevent commits that include changes in specified file and folder paths from being pushed to the commit graph. This includes absolute paths that contain file names.
Input fields for FilePathRestrictionParametersInput
Name | Description |
---|---|
| The file paths that are restricted from being pushed to the commit graph. |
FollowOrganizationInput
Autogenerated input type of FollowOrganization.
FollowUserInput
Autogenerated input type of FollowUser.
GistOrder
Ordering options for gist connections.
Input fields for GistOrder
Name | Description |
---|---|
| The ordering direction. |
| The field to order repositories by. |
GrantEnterpriseOrganizationsMigratorRoleInput
Autogenerated input type of GrantEnterpriseOrganizationsMigratorRole.
Input fields for GrantEnterpriseOrganizationsMigratorRoleInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The ID of the enterprise to which all organizations managed by it will be granted the migrator role. |
| The login of the user to grant the migrator role. |
GrantMigratorRoleInput
Autogenerated input type of GrantMigratorRole.
Input fields for GrantMigratorRoleInput
Name | Description |
---|---|
| The user login or Team slug to grant the migrator role. |
| Specifies the type of the actor, can be either USER or TEAM. |
| A unique identifier for the client performing the mutation. |
| The ID of the organization that the user/team belongs to. |
ImportProjectInput
Autogenerated input type of ImportProject.
Input fields for ImportProjectInput
Name | Description |
---|---|
| The description of Project. |
| A unique identifier for the client performing the mutation. |
| A list of columns containing issues and pull requests. |
| The name of Project. |
| The name of the Organization or User to create the Project under. |
| Whether the Project is public or not. |
InviteEnterpriseAdminInput
Autogenerated input type of InviteEnterpriseAdmin.
Input fields for InviteEnterpriseAdminInput
Name | Description |
---|---|
| A unique identifier for the client performing the mutation. |
| The email of the person to invite as an administrator. |
| The ID of the enterprise to which you want to invite an administrator. |
| The login of a user to invite as an administrator. |
|