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